Smitey Ticket-SystemSmiteyTicket-System

내려받기

사용해 보실 소프트웨어와 화면용 언어 팩을 한곳에 모았습니다.

30일 동안 사용해 보십시오. 제한은 없습니다.

체험판에는 Professional의 전체 기능이 들어 있습니다. 30일이 지나면 라이선스를 구매할지 결정하시면 되고, 데이터는 그대로 남습니다. 라이선스 키를 넣으면 체험판이 정식 버전이 되며 재설치는 필요 없습니다.

두 꾸러미에 들어 있는 소프트웨어는 같습니다. 쓰시는 운영체제만 고르십시오.

공개 도메인에서 자동 HTTPS를 쓰려면 티켓 시스템에 포트 80과 443이 필요합니다. 다른 포트로 대신할 수 없으며, 이는 Let’s Encrypt 인증서 절차가 정한 것입니다. 예를 들어 웹 서버가 이미 그 포트를 쓰고 있다면 두 가지 방법이 있습니다. 그 프로그램을 멈추거나 지우십시오, 아니면 티켓 시스템을 다른 서버에 설치하십시오. 원하는 포트를 고를 수 있는 것은 자동 HTTPS 없이 운영할 때뿐입니다. 설치 프로그램은 설치 전에 포트를 확인하고 그 포트를 잡고 있는 프로그램의 이름을 알려 줍니다.

Windows에 설치하기

약 6분, 영어 자막.

Linux에 설치하기

약 5분, 영어 자막.

3단계로 준비 끝

1

내려받기

체험판 꾸러미를 내려받아 풀어 주십시오.

2

설치

Docker Compose로 시작하십시오. 함께 들어 있는 안내가 차례대로 알려 줍니다.

3

사용 시작

팀을 만들고, 메일함을 연결하고, 첫 티켓을 만드십시오.

중요한 명령(Linux)

그대로 복사해 쓰실 수 있습니다. 모두 sudo와 함께 씁니다. 설치 프로그램과 컨테이너에는 root 권한이 필요합니다.

필수 구성 요소 설치

sudo apt install -y unzip

unzip이 없으면 설치 프로그램이 꾸러미를 풀지 못합니다.

티켓 시스템 설치

curl -fsSL https://files.smitey.eu/download/get-smitey.sh | sudo bash

꾸러미를 내려받고 질문을 차례대로 안내합니다. 다시 실행해도 안전합니다. 설정과 자료는 그대로 남습니다.

HTTPS 확인

sudo /opt/smitey/smitey-install check-https

공개 도메인이 있을 때만 해당합니다. 인증서가 있는지 알려 주고, 없으면 기록에 남은 이유를 알려 줍니다. 인증서는 설치가 끝난 뒤 몇 분 지나서 올 수도 있습니다.

첫 로그인 정보 확인

sudo cat /opt/smitey/SMITEY-credentials.txt

처음 로그인한 뒤에는 비밀번호를 바꾸고 이 파일을 지우십시오.

컨테이너가 돌고 있습니까?

sudo podman ps

시스템의 모든 부분을 상태와 함께 보여 줍니다.

기록 따라 보기

sudo podman logs -f container-backend-1

백엔드가 알리는 내용을 실시간으로 보여 줍니다. Ctrl+C로 멈춥니다.

감독 서비스 확인

systemctl status smitey-supervisor

이 서비스가 시스템을 계속 돌게 하고, 프로그램 안에서 시작한 업데이트를 적용합니다.

지원 꾸러미 만들기

sudo /opt/smitey/install.sh --support-bundle

기록과 시스템 상태를 zip 파일 하나에 모읍니다. 비밀번호와 키는 제거됩니다.

공개 주소 바꾸기

sudo /opt/smitey/install.sh --reconfigure

새 도메인을 넣고 다시 시작하므로 새 이름으로 인증서를 요청합니다.

제거하기

sudo /opt/smitey/install.sh --uninstall

자료와 Podman에 대해 따로 묻습니다. 묻지 않고 지우는 것은 없습니다.

백업은 /opt/smitey/Backup/TicketSystemBackup이 맡습니다(list, backup, restore). 매일 백업은 저절로 돕니다. 자세한 내용은 /opt/smitey/docs/ko/BACKUP-RESTORE.txt에 있습니다.

시스템 요구 사항

  • Linux: Ubuntu 24.04 또는 26.04 LTS. 시험을 마친 판입니다. Podman 4.1 이상과 systemd, apt를 갖춘 다른 배포판도 동작할 것으로 보이지만 시험하지 않았습니다
  • Windows 11 Professional(시험 완료). Windows Server 2022 이상도 동작할 것으로 보이지만(WSL2가 그때 들어왔습니다) 시험하지 않았습니다
  • 권장하지 않음: Windows 10. 21H2 이상에서 동작하는 것을 확인했지만 2025년 10월 14일 이후로 보안 업데이트가 없습니다. 고객 데이터를 담는 시스템의 바탕으로는 알맞지 않습니다
  • x86_64/amd64 전용. Raspberry Pi나 ARM VPS 같은 ARM 시스템에서는 동작하지 않습니다
  • PostgreSQL 데이터베이스와 컨테이너 런타임이 꾸러미에 함께 들어 있으며 설치 프로그램이 둘 다 설정합니다
  • Linux: 최소 CPU 2코어와 메모리 2GB, 4코어와 4GB 권장
  • Windows: 최소 CPU 4코어와 메모리 8GB, 6코어와 16GB 권장. Windows에서는 전체 구성이 자체 가상 머신(WSL2) 안에서 돌아가며 메모리와 코어를 Windows와 나누어 씁니다
  • 비어 있는 네트워크 포트 하나: 고르신 HTTP 포트(기본값 8088) 또는 80. 포트 80을 쓰면 IP 주소로도 바로 접속할 수 있습니다
  • 자동 HTTPS(Let’s Encrypt)에는 공개 도메인과 인터넷에서 닿을 수 있는 포트 80, 443이 필요합니다. 포트 80은 설치할 때만이 아니라 계속 열려 있어야 합니다. 인증서를 60일마다 갱신하기 때문입니다. 공개 도메인 없이 사내 망에서 쓰는 경우에는 직접 준비한 인증서로 HTTPS를 쓸 수 있으며, 설치 꾸러미에 그 방법을 함께 담았습니다
  • 최신 브라우저: Chrome, Edge, Firefox, Safari

네트워크와 포트

티켓 시스템은 고객의 서버에서 돌아갑니다. 모든 기능이 동작하려면 방화벽이 다음 연결을 허용해야 합니다. VPS라면 서버의 방화벽뿐 아니라 호스팅 업체의 방화벽도 함께 보아야 합니다.

수신(서버로 들어오는 연결)

  • 수신 · 허용TCP 8088(또는 고르신 HTTP 포트)사내 망에서 티켓 시스템에 접속합니다.
  • 수신 · 허용TCP 80과 443자동 HTTPS에만 필요합니다. 포트 80은 설치할 때만이 아니라 계속 열려 있어야 합니다. Let’s Encrypt가 60일마다 이 포트로 인증서를 갱신하기 때문입니다.
  • 수신 · 허용TCP 22(SSH)Linux에서 직접 관리할 때만 필요합니다. 티켓 시스템 자체에는 필요하지 않습니다.
  • 수신 · 차단TCP 5432(PostgreSQL)데이터베이스는 컨테이너 네트워크에서 돌아가며 바깥에서 닿을 필요가 전혀 없습니다.

발신(서버에서 인터넷으로 나가는 연결)

  • 발신 · 허용UDP/TCP 53(DNS), UDP 123(NTP)이름 확인과 정확한 시계에 필요합니다. 시계가 어긋나면 TLS 연결이 실패합니다.
  • 발신 · 허용TCP 443(HTTPS)설치, 업데이트, 라이선스 확인에 필요합니다.
  • 발신 · 허용TCP 587 또는 465(SMTP)이메일 발송에 필요합니다. 알림, 초대, 비밀번호 재설정이 여기에 해당합니다. 둘 중 어느 쪽인지는 이메일 제공자가 정합니다.
  • 발신 · 허용TCP 993(IMAP)받은 메일을 자동으로 티켓으로 만들려면 필요합니다.
  • 발신 · 차단TCP 25(SMTP)필요하지 않습니다. 발송은 587이나 465로 나갑니다. 계속 막아 두십시오. 서버가 뚫렸을 때 스팸이 나가는 통로가 바로 포트 25입니다.
이메일을 쓰실 계획이라면 중요합니다. 많은 호스팅 업체가 기본 방화벽에서 나가는 메일 트래픽(포트 25, 465, 587)을 막아 둡니다. netcup에서는 그 규칙 이름이 “Mail block”입니다. 증상은 분명합니다. 받아 오는 것은 되는데 보내는 것이 시간 초과로 끝납니다. 그 차단은 서버가 아니라 업체 쪽에 있으며 업체의 관리 화면에서만 풀 수 있습니다. 이때 포트 25는 필요하지 않으니 계속 막아 두십시오.

메일함 연결하기: 어떤 제공자가 바로 되는지, Microsoft 365에는 무엇이 필요한지 →

언어 팩

모든 설치 환경은 영어로 시작합니다. 언어 팩은 번역된 화면 텍스트가 담긴 JSON 파일입니다. 내려받아 가져오면 끝입니다. 티켓, 팀, 카테고리처럼 직접 만든 내용은 영향을 받지 않습니다.

쓰시는 언어가 없습니까?

언어 팩을 계속 준비하고 있습니다. 필요한 언어를 알려 주십시오. 직접 번역하고 싶으시다면, 티켓 시스템이 전체 텍스트 목록을 JSON으로 내보냅니다. 그 파일의 항목을 쓰시는 언어로 채워 다시 가져오시면 됩니다.

문의하기

언어 팩을 가져오는 방법

  1. 파일 내려받기

    위에서 언어 팩을 내려받아 JSON 파일 그대로 저장하십시오. 압축을 풀거나 이름을 바꾸거나 내용을 고치지 마십시오.

  2. 관리자로 로그인

    티켓 시스템에 관리자로 로그인한 다음 Settings → Language를 여십시오.

  3. 가져오기

    그곳에서 “Import”를 고르고 내려받은 파일을 올리십시오. 가져오기가 끝나면 몇 개 항목이 반영되었는지 알려 줍니다.

  4. 언어 켜기

    새 언어를 켜십시오. 그때부터 사용자는 각자 개인 메뉴에서 자기 언어를 고르고, 팀마다 기본 언어를 둘 수 있습니다.

이 팩이 제 버전에 맞습니까?

맞습니다. 언어 팩은 특정 버전에 묶여 있지 않습니다. 설치 환경이 모르는 항목은 가져올 때 그냥 건너뜁니다. 팩보다 새로 생긴 기능은 다음 팩이 나올 때까지 영어로 보입니다. 가져오기는 언제든지 다시 할 수 있습니다.

참고: 가져오기는 기존 번역을 팩의 내용으로 덮어씁니다. 텍스트를 직접 고치신 적이 있다면 먼저 현재 상태를 내보내 보관해 두십시오.