Установка ПО · 5 min read · Dec 21, 2025

Как установить Helpy Customer Helpdesk на Ubuntu 20.04

Helpy — это бесплатное, с открытым исходным кодом и современное приложение службы поддержки клиентов, которое предоставляет вашим клиентам героический опыт. Оно написано на Ruby on Rails и может быть легко интегрировано с вашим приложением и входящей электронной почтой через Sendgrid, Mandrill, Mailgun и т. д. По умолчанию Helpy работает на всех устройствах из коробки, так что вы можете радовать клиентов быстрыми ответами, откуда угодно и в любое время! У него есть расширенная функция поиска, которая помогает вам фильтровать и находить заявки или клиентов, когда у вас их тысячи.

В этом посте мы покажем вам, как установить Helpy Helpdesk на Ubuntu 20.04.

Предварительные требования

  • Сервер с установленной Ubuntu 20.04.
  • Настроенный root-пароль на сервере.

Начало работы

Перед началом рекомендуется обновить все системные пакеты до последней версии. Вы можете сделать это, выполнив следующую команду:

apt-get update -y

После обновления системных пакетов установите другие необходимые зависимости, используя следующую команду:

apt-get install apt-transport-https ca-certificates curl software-properties-common

После установки всех пакетов вы можете перейти к следующему шагу.

Установка Docker CE и Docker Compose

Мы будем устанавливать Helpy в контейнере Docker. Поэтому Docker и Docker Compose должны быть установлены на вашем сервере. Сначала добавьте репозиторий Docker CE, используя следующую команду:

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | apt-key add -  
add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"

Затем обновите базу данных репозитория и установите Docker CE с помощью следующей команды:

apt-get update -y  
apt-get install docker-ce docker-ce-cli containerd.io -y

После установки Docker CE запустите и активируйте службу Docker CE, используя следующую команду:

systemctl start docker   
systemctl enable docker

Затем проверьте статус Docker CE с помощью следующей команды:

systemctl status docker

Вы получите следующий вывод:

? docker.service - Docker Application Container Engine
     Loaded: loaded (/lib/systemd/system/docker.service; enabled; vendor preset: enabled)
     Active: active (running) since Mon 2022-02-28 02:01:20 UTC; 1min 14s ago
TriggeredBy: ? docker.socket
       Docs: https://docs.docker.com
   Main PID: 3092 (dockerd)
      Tasks: 7
     Memory: 28.2M
     CGroup: /system.slice/docker.service
             ??3092 /usr/bin/dockerd -H fd:// --containerd=/run/containerd/containerd.sock

Feb 28 02:01:20 ubuntu2004 dockerd[3092]: time="2022-02-28T02:01:20.107814282Z" level=warning msg="Ваше ядро не поддерживает CPU realtime >
Feb 28 02:01:20 ubuntu2004 dockerd[3092]: time="2022-02-28T02:01:20.107957338Z" level=warning msg="Ваше ядро не поддерживает cgroup blkio >
Feb 28 02:01:20 ubuntu2004 dockerd[3092]: time="2022-02-28T02:01:20.108078251Z" level=warning msg="Ваше ядро не поддерживает cgroup blkio >
Feb 28 02:01:20 ubuntu2004 dockerd[3092]: time="2022-02-28T02:01:20.108501788Z" level=info msg="Загрузка контейнеров: старт."
Feb 28 02:01:20 ubuntu2004 dockerd[3092]: time="2022-02-28T02:01:20.257733781Z" level=info msg="Стандартный мост (docker0) назначен с >
Feb 28 02:01:20 ubuntu2004 dockerd[3092]: time="2022-02-28T02:01:20.354919857Z" level=info msg="Загрузка контейнеров: завершено."
Feb 28 02:01:20 ubuntu2004 dockerd[3092]: time="2022-02-28T02:01:20.382579537Z" level=info msg="Демон Docker" commit=459d0df graphdriver(s)=>
Feb 28 02:01:20 ubuntu2004 dockerd[3092]: time="2022-02-28T02:01:20.383119787Z" level=info msg="Демон завершил инициализацию"
Feb 28 02:01:20 ubuntu2004 systemd[1]: Started Docker Application Container Engine.
Feb 28 02:01:20 ubuntu2004 dockerd[3092]: time="2022-02-28T02:01:20.444535011Z" level=info msg="API слушает на /run/docker.sock"

Затем загрузите последнюю версию Docker Compose с помощью следующей команды:

curl -s https://api.github.com/repos/docker/compose/releases/latest | grep browser_download_url | grep docker-compose-linux-x86_64 | cut -d '"' -f 4 | wget -qi -

Затем установите разрешение на выполнение для бинарного файла Docker Compose с помощью следующей команды:

chmod +x docker-compose-linux-x86_64

Затем переместите бинарный файл Docker Compose в системный путь с помощью следующей команды:

mv docker-compose-linux-x86_64 /usr/local/bin/docker-compose

Затем проверьте версию Docker Compose с помощью следующей команды:

docker-compose version

Вы получите следующий вывод:

Docker Compose version v2.2.3

Установка Helpy

Затем загрузите последнюю версию Helpy с помощью следующей команды:

git clone https://github.com/helpyio/helpy.git

После завершения загрузки перейдите в директорию helpy и переименуйте файл окружения:

cd helpy  
cp docker/.env.sample docker/.env

Затем отредактируйте Caddyfile и укажите IP-адрес вашего сервера:

nano docker/Caddyfile

Укажите IP-адрес вашего сервера, как показано ниже:

your-server-ip:80 {
  tls off
  root /helpy/public

  header /assets {
    gzip
    Expires "Thu, 31 Dec 2037 23:55:55 GMT"
    Cache-Control public
  }

  header /uploads

  proxy / helpy:8080/ {
    except /assets
    except /uploads
    header_upstream Host {host}
    header_upstream X-Real-IP {remote}
    header_upstream X-Forwarded-Proto {scheme}
  }
  log stdout
}

Сохраните и закройте файл, затем соберите контейнер Helpy с помощью следующей команды:

docker-compose build

Вы должны увидеть следующий вывод:

 ---> Running in a3a5fe591ac2
Removing intermediate container a3a5fe591ac2
 ---> 7babb0f60867
Step 13/20 : VOLUME $HELPY_HOME/public
 ---> Running in bfc08d37a2e1
Removing intermediate container bfc08d37a2e1
 ---> b4a06ac5bd7b
Step 14/20 : USER root
 ---> Running in a2e81c390825
Removing intermediate container a2e81c390825
 ---> d4275c0cd8aa
Step 15/20 : COPY . $HELPY_HOME/
 ---> 03684c78036c
Step 16/20 : RUN chown -R $HELPY_USER $HELPY_HOME
 ---> Running in 5b8d7b23cab6
Removing intermediate container 5b8d7b23cab6
 ---> 8406e643b688
Step 17/20 : USER $HELPY_USER
 ---> Running in bf9c512f2486
Removing intermediate container bf9c512f2486
 ---> abccf6d62cdf
Step 18/20 : COPY docker/database.yml $HELPY_HOME/config/database.yml
 ---> fbff2ecf5a58
Step 19/20 : EXPOSE 3000
 ---> Running in db600cd62ecc
Removing intermediate container db600cd62ecc
 ---> 8ed9fd111cd4
Step 20/20 : CMD ["/bin/bash", "/helpy/docker/run.sh"]
 ---> Running in 4c48d0132cd3
Removing intermediate container 4c48d0132cd3
 ---> ac095ecbbac6
Successfully built ac095ecbbac6
Successfully tagged helpy_helpy:latest

Use 'docker scan' to run Snyk tests against images to find vulnerabilities and learn how to fix them

Затем запустите контейнер Helpy с помощью следующей команды:

docker-compose up -d

Вы должны увидеть следующий вывод:

[+] Running 19/19
 ? postgres Pulled                                                                                                                      16.6s
   ? 619014d83c02 Pull complete                                                                                                          8.0s
   ? 7ec0fe6664f6 Pull complete                                                                                                          8.7s
   ? 9ca7ba8f7764 Pull complete                                                                                                          8.9s
   ? 9e1155d037e2 Pull complete                                                                                                          9.2s
   ? febcfb7f8870 Pull complete                                                                                                         10.4s
   ? 8c78c79412b5 Pull complete                                                                                                         10.5s
   ? 5a35744405c5 Pull complete                                                                                                         10.6s
   ? 27717922e067 Pull complete                                                                                                         10.6s
   ? 36f0c5255550 Pull complete                                                                                                         15.2s
   ? dbf0a396f422 Pull complete                                                                                                         15.3s
   ? ec4c06ea33e5 Pull complete                                                                                                         15.4s
   ? e8dd33eba6d1 Pull complete                                                                                                         15.5s
   ? 51c81b3b2c20 Pull complete                                                                                                         15.6s
   ? 2a03dd76f5d7 Pull complete                                                                                                         15.7s
 ? frontend Pulled                                                                                                                      11.3s
   ? 743f2d6c1f65 Pull complete                                                                                                          7.8s
   ? 6bfc4ec4420a Pull complete                                                                                                         10.2s
   ? 688a776db95f Pull complete                                                                                                         10.4s
[+] Running 6/6
 ? Network helpy_front          Created                                                                                                  0.1s
 ? Network helpy_back           Created                                                                                                  0.1s
 ? Volume "helpy_rails-assets"  Created                                                                                                  0.0s
 ? Container helpy-postgres-1   Started                                                                                                  1.4s
 ? Container nginx              Started                                                                                                  1.5s
 ? Container helpy-helpy-1      Started                                                                                                  3.3s

Затем проверьте все работающие контейнеры с помощью следующей команды:

docker ps

Вы должны увидеть следующий вывод:

CONTAINER ID   IMAGE          COMMAND                  CREATED         STATUS         PORTS                                                                      NAMES
8168c6d11c75   helpy_helpy    "/bin/bash /helpy/do…"   2 minutes ago   Up 2 minutes   0.0.0.0:3000->3000/tcp, :::3000->3000/tcp                                  helpy-helpy-1
265597cbcbea   postgres:9.4   "docker-entrypoint.s…"   2 minutes ago   Up 2 minutes   5432/tcp                                                                   helpy-postgres-1
b671e0a7ba1e   nginx:1.15     "nginx -g 'daemon of…"   2 minutes ago   Up 2 minutes   0.0.0.0:80->80/tcp, :::80->80/tcp, 0.0.0.0:443->443/tcp, :::443->443/tcp   nginx

Доступ к веб-интерфейсу Helpy

Теперь откройте веб-браузер и получите доступ к веб-интерфейсу Helpy, используя URL http://your-server-ip. Вы должны увидеть следующий экран:

Нажмите на Давайте настроим ваш Helpy. Вы должны увидеть экран создания учетной записи администратора:

Укажите ваше имя администратора, пароль, адрес электронной почты и нажмите кнопку Сохранить изменения. Вы должны увидеть экран настройки вашего справочного центра:

Настройте ваш справочный центр в соответствии с вашими потребностями, в противном случае нажмите кнопку Пропустить на сейчас. Вы должны увидеть экран конфигурации SMTP-сервера:

Укажите информацию о вашем SMTP-сервере или нажмите кнопку Пропустить на сейчас. Вы должны увидеть следующий экран:

Нажмите кнопку Начать!. Вы должны увидеть панель управления Helpy на следующем экране:

Заключение

Поздравляем! Вы успешно установили систему Helpy Customer Helpdesk на Ubuntu 20.04. Теперь вы можете развернуть Helpy в вашей организации и начать управлять вашими клиентами. Не стесняйтесь задавать мне вопросы, если у вас есть какие-либо.

Share: X/Twitter LinkedIn

Get new posts in your inbox

No spam. Unsubscribe anytime.