설치 가이드 · 5 min read · Dec 21, 2025
Ubuntu 20.04에 Helpy 고객 헬프데스크 설치하는 방법
Helpy는 고객에게 영웅적인 경험을 제공하는 무료 오픈 소스 현대 헬프데스크 고객 지원 애플리케이션입니다. Ruby on Rails로 작성되었으며 Sendgrid, Mandrill, Mailgun 등을 통해 애플리케이션 및 수신 이메일과 쉽게 통합할 수 있습니다. 기본적으로 Helpy는 모든 장치에서 즉시 작동하므로 언제 어디서나 신속한 답변으로 고객을 기쁘게 할 수 있습니다! 수천 개의 티켓이나 고객이 있을 때 필터링하고 찾는 데 도움이 되는 고급 검색 옵션이 있습니다.
이 게시물에서는 Ubuntu 20.04에 Helpy 헬프데스크를 설치하는 방법을 보여드리겠습니다.
필수 조건
- Ubuntu 20.04를 실행하는 서버.
- 서버에 루트 비밀번호가 구성되어 있어야 합니다.
시작하기
시작하기 전에 모든 시스템 패키지를 최신 버전으로 업데이트하는 것이 좋습니다. 다음 명령어를 실행하여 수행할 수 있습니다:
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 -yDocker 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="Your kernel does not support CPU realtime >
Feb 28 02:01:20 ubuntu2004 dockerd[3092]: time="2022-02-28T02:01:20.107957338Z" level=warning msg="Your kernel does not support cgroup blkio >
Feb 28 02:01:20 ubuntu2004 dockerd[3092]: time="2022-02-28T02:01:20.108078251Z" level=warning msg="Your kernel does not support cgroup blkio >
Feb 28 02:01:20 ubuntu2004 dockerd[3092]: time="2022-02-28T02:01:20.108501788Z" level=info msg="Loading containers: start."
Feb 28 02:01:20 ubuntu2004 dockerd[3092]: time="2022-02-28T02:01:20.257733781Z" level=info msg="Default bridge (docker0) is assigned with an >
Feb 28 02:01:20 ubuntu2004 dockerd[3092]: time="2022-02-28T02:01:20.354919857Z" level=info msg="Loading containers: done."
Feb 28 02:01:20 ubuntu2004 dockerd[3092]: time="2022-02-28T02:01:20.382579537Z" level=info msg="Docker daemon" commit=459d0df graphdriver(s)=>
Feb 28 02:01:20 ubuntu2004 dockerd[3092]: time="2022-02-28T02:01:20.383119787Z" level=info msg="Daemon has completed initialization"
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 listen on /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.3Helpy 설치
다음으로, 다음 명령어로 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 nginxHelpy 웹 인터페이스 접근
이제 웹 브라우저를 열고 URL http://your-server-ip를 사용하여 Helpy 웹 인터페이스에 접근합니다. 다음 화면을 볼 수 있어야 합니다:
Helpy 설정 시작하기를 클릭합니다. 관리자 계정 생성 화면이 표시됩니다:
관리자 사용자 이름, 비밀번호, 이메일 주소를 입력하고 변경 사항 저장 버튼을 클릭합니다. 헬프데스크 사용자 정의 화면이 표시됩니다:
필요에 따라 헬프데스크를 사용자 정의하거나 지금 건너뛰기 버튼을 클릭합니다. SMTP 서버 구성 화면이 표시됩니다:
SMTP 서버 정보를 제공하거나 지금 건너뛰기 버튼을 클릭합니다. 다음 화면이 표시됩니다:
시작하기! 버튼을 클릭합니다. 다음 화면에서 Helpy 대시보드를 볼 수 있습니다:
결론
축하합니다! Ubuntu 20.04에 Helpy 고객 헬프데스크 시스템을 성공적으로 설치했습니다. 이제 조직에 Helpy를 배포하고 고객을 관리할 수 있습니다. 질문이 있으면 언제든지 문의해 주세요.
새 게시물을 받은 편지함에서 받기
스팸은 없습니다. 언제든지 구독 해지 가능합니다.