미니톡 서버프로그램 설치

미니톡 서버프로그램을 설치하기 위해서는 ROOT 권한을 가진 리눅스 서버가 필요합니다.
미니톡 서버프로그램 v8.x 은 Node.js 24 버전 이상(npm 11 이상) 및 MongoDB 8 버전이 추가적으로 필요하며, 미니톡 클라이언트 v8.x 와 함께 사용합니다.
서버를 직접 운영하기 어려운 경우 미니톡 채팅호스팅 또는 서버호스팅을 이용하실 수 있습니다.

Node.js 및 MongoDB 설치

Node.js 는 https://nodejs.org 홈페이지를 참고하여 자신의 시스템에 맞는 방법으로 Node.js 24 이상 버전을 설치하여 주시면 됩니다.
MongoDB 는 https://www.mongodb.com 홈페이지를 참고하여 자신의 시스템에 맞는 방법으로 MongoDB 8 버전을 설치하여 주시면 됩니다.
MongoDB 는 보안을 위해 사용자 인증을 사용하고, 미니톡 서버프로그램이 사용할 데이터베이스(예 : minitalk)와 계정을 추가하는 것을 권장합니다.
채팅기록 영구보관은 미니톡 클라이언트가 설치된 서버의 MySQL 에 기록되며, MongoDB 에는 임시 대화기록 등이 저장됩니다.

미니톡 서버프로그램 설치

미니톡 서버프로그램 라이선스를 미니톡서비스 > 서버라이선스 페이지에서 구매하신 후, 미니톡 다운로드 페이지에서 v8.x 서버프로그램을 포함하여 다운로드 받습니다.
다운로드 받은 서버프로그램 폴더를 서버의 원하는 경로에 업로드한 뒤, 해당 폴더에서 아래 명령어로 환경설정 파일을 만듭니다.

$ cp configs.sample.js configs.js
$ vi configs.js

configs.js 파일의 주요 설정은 아래와 같습니다. 그 외 설정(workers, trustedProxies, publicUrl, cloudflare, server.checkIp, server.usercodeLifetime 등)은 configs.sample.js 파일의 주석을 참고하여 주시기 바랍니다.

module.exports = {
    // 미니톡 홈페이지에서 구매한 서버프로그램 라이선스키
    license:"",
    // 미니톡 서버 도메인 또는 아이피 (https 를 사용할 경우 도메인이 필요합니다.)
    host:"www.yourdomain.com",
    // 미니톡 서버프로그램 포트번호
    port:3121,
    // https 사용여부 (https 사용시 인증서파일이 필요합니다.)
    https:true,
    // 인증서 파일 경로
    certificate:{
        key:"/yourpath/private.key",
        cert:"/yourpath/yourdomain.crt",
        ca:"/yourpath/bundle.ca"
    },
    // 미니톡 클라이언트 API 주소 및 클라이언트 설치시 입력한 암호화키
    client:{
        url:"https://www.yourdomain.com/minitalk/api/index.php",
        secret_key:"yoursecretkey"
    },
    // 몽고디비 접속 URL
    mongodb:"mongodb://mongodb_id:mongodb_password@localhost:27017/minitalk"
};

server.usercodeLifetime 은 발급시각이 포함된 유저코드의 유효기간(초)으로 기본값은 604800 (7일) 입니다.

환경설정파일 수정을 마쳤다면, 아래 명령어로 필수 Node.js 모듈을 설치하고 미니톡 서버프로그램을 실행합니다.

$ npm ci --ignore-scripts
$ npm start

서버프로그램은 실행시 라이선스를 확인하며, 라이선스에 등록된 서버의 IP 에서만 실행됩니다.

미니톡 서버프로그램 서비스 등록

v8.x 부터는 node app.js install, stop, restart 명령어 대신 리눅스 systemd 서비스로 미니톡 서버프로그램을 제어합니다.
서버프로그램에 포함된 deploy/minitalk.service 파일을 참고하여 서비스를 등록한 뒤, 아래 명령어로 미니톡 서버프로그램을 제어할 수 있습니다.

$ systemctl start minitalk
$ systemctl stop minitalk
$ systemctl restart minitalk
$ systemctl status minitalk

이전 버전(v7.x)의 서버프로그램을 실행중인 경우, 기존 서버프로그램 폴더에서 node app.js stop 명령어로 이전 서버프로그램을 먼저 종료한 뒤 v8.x 서버프로그램을 실행하여 주시기 바랍니다.
서버프로그램 설치가 완료되면 미니톡 클라이언트 관리자의 서버관리 메뉴에서 서버를 등록합니다.

서버관리