서버 관리하기
사바쨩으로 게임 서버를 운영하는 일상 워크플로우. 서버 추가·시작·모니터링부터 백업·예약 작업, 친구 초대, 디스코드 연동까지.
서버 관리하기
이 문서는 사바쨩(Saba-chan)을 사용자 입장에서 어떻게 사용하는지 안내합니다. 모듈 코드를 뜯거나 익스텐션을 직접 짜지 않더라도, 이 문서 한 편이면 친구들과 게임할 서버 한두 대를 운영하는 데 충분합니다.
설치는 시작하기에서, 봇 페어링은 디스코드 봇 & 서버쨩에서 다룹니다. 여기서는 이미 설치를 마친 분이 GUI를 열어 두고 무엇을 누르고 무엇을 확인하는지에 집중합니다.
1. 큰 그림: GUI는 리모컨, 서버는 데몬이 돌린다
먼저 알아 둘 점이 있습니다. GUI 창을 닫아도 게임 서버는 꺼지지 않습니다.
saba-chan-gui(창): 데몬에 명령을 전달하고 화면에 보여 주는 리모컨. CLI(saba-chan-cli)도 같은 역할을 합니다.saba-core(데몬): 백그라운드에서 게임 서버를 띄우고 감시하는 본체. 서버 실행, 백업, 예약 작업, 디스코드 연결을 모두 데몬이 맡습니다.- 게임 서버 프로세스: 데몬이 띄운 실제 서버(
java,PalServer.exe등).
따라서 일상적인 운영은 다음과 같습니다.
- GUI를 실행하면 데몬이 같이 뜹니다(이미 떠 있으면 그대로 붙습니다).
- 친구들이 들어올 시간에 서버 화면에서 켜기 버튼을 누릅니다.
- 게임 중에는 창을 최소화하거나 닫아도 됩니다. 창을 닫으면 인터페이스만 종료(데몬은 계속 실행)와 완전히 종료(데몬까지 종료) 중에서 고릅니다. 서버를 계속 돌리려면 인터페이스만 종료를 고르세요.
- 모임이 끝나면 GUI를 다시 열어 끄기 버튼을 누릅니다.
PC를 끄면 게임 서버도 같이 꺼집니다. 데몬은 사용자 PC에서만 동작하므로, 24시간 운영이 필요하면 별도 호스팅을 쓰는 편이 낫습니다.
2. 첫 서버 만들기 (간단 요약)
자세한 설치 과정은 시작하기를 참고하세요. 요약하면:
- 서버 화면의 서버 추가 버튼을 누릅니다.
- 새 서버 만들기를 고릅니다. 쓰던 서버 폴더가 있다면 기존 서버 가져오기로 연결할 수 있습니다(파일은 원래 자리에 남습니다).
- 게임(Minecraft / Palworld / Project Zomboid / Terraria 등)을 고르고, 서버 이름과 추천 설정을 정합니다.
- 게임에 약관이 있으면 여기서 동의합니다. 예를 들어 마인크래프트는 Minecraft EULA에 동의해야 서버를 켤 수 있습니다(§3.7).
- 서버 추가를 누르면 서버 파일을 자동으로 내려받고, 진행률이 서버 화면에 표시됩니다.
- 설치가 끝나면 서버가 목록에 추가됩니다.
서버 이름은 "친구들과 보내는 마인크래프트", "주말 좀보이드"처럼 자유롭게 정해도 됩니다. 디스코드 명령에서는 서버 이름이나 게임 이름(별명)으로 서버를 가리킬 수 있습니다. 이름은 서버가 꺼져 있을 때 이름 옆 연필 버튼으로 바꿀 수 있습니다.
3. 일상 운영 흐름
서버를 고르면 오른쪽에 서버 화면이 열립니다. 위쪽에 켜기/끄기 버튼과 상태가 있고, 아래에 탭이 있습니다. 게임에 따라 보이는 탭이 다릅니다.
| 탭 | 내용 |
|---|---|
| 콘솔 | 서버 출력과 명령 입력 (콘솔을 지원하는 게임만) |
| 명령 | 게임이 정해 둔 명령 목록 (예: 팰월드 공지·플레이어 목록) |
| 설정 | 게임 설정(포트, 최대 인원, 비밀번호 등) |
| 사바쨩 | 사바쨩이 서버를 다루는 설정: 자동 재시작, 메모리 상한, 정지 대기 시간, 실행 인자 미리보기, 게임 채팅 전달 |
| 백업·예약 | 백업 만들기·복원, 예약 작업 |
| 디스코드 | 디스코드에서 이 서버와 명령을 부르는 말 |
| 기록 | 누가 언제 켜고 끄고 명령을 보냈는지 |
| 정보 | 포트·버전·가동 시간, 최근 종료 기록, 서버 점검, 서버 폴더 열기, 서버 삭제 |
3.1 켜기 / 끄기 / 재시작
- 켜기: 데몬이 먼저 약관 동의와 모듈 점검을 확인하고 서버를 띄웁니다. 점검에서 치명적인 문제가 나오면 켜지 않고 이유를 알려 줍니다.
- 끄기: 게임의 정상 종료 명령(예: 마인크래프트
stop, 좀보이드quit)을 보내고 기다립니다. 정지 대기 시간(기본 30초, 게임마다 다르고 사바쨩 탭에서 바꿀 수 있음) 안에 꺼지지 않으면 강제로 종료합니다. - 재시작: 끄기 → 켜기를 한 번에 합니다. 접속한 사람은 잠시 끊깁니다.
3.2 콘솔 보기 / 명령 입력
- 콘솔 탭에 게임 서버의 출력이 실시간으로 표시됩니다.
- 입력창에 명령어를 치고 Enter를 누르면 **서버 콘솔(stdin)**로 전달됩니다. 예: 마인크래프트에서
say 안녕!,op 친구닉. ↑ 키로 이전 명령을 불러올 수 있습니다. - 명령은 stdin → REST → RCON 순서로 갑니다. 콘솔이 없는 게임(팰월드처럼 REST API로만 다루는 게임)은 명령 탭의 정해진 명령으로 다룹니다. RCON은 다른 경로가 없는 게임에만 쓰며, 데몬이 인스턴스마다 정한 포트와 무작위 비밀번호로 루프백(127.0.0.1)에서만 연결합니다.
- 콘솔은 별도 창으로 분리할 수 있고, Windows에서는 터미널로 열기로 CLI 콘솔을 띄울 수도 있습니다.
- 데몬은 서버마다 최근 콘솔 줄(최대 1만 줄)을 메모리에 두고, 같은 내용을 서버 폴더의
logs/아래 파일에도 남깁니다.
3.3 여러 서버 동시 운영
- 같은 게임의 서버를 여러 개 만들 수도 있고(예: "바닐라 마크"와 "모드팩 마크"), 서로 다른 게임을 동시에 띄울 수도 있습니다.
- 각 서버의 포트(게임이 접속을 받는 번호)는 겹치면 안 됩니다. 새 서버를 만들 때 사바쨩이 다른 서버와 겹치지 않게 기본 포트를 옮겨 주고, 포트가 겹치면 서버 화면에 경고가 표시됩니다. 포트는 설정 탭에서 바꿀 수 있습니다.
- 서버가 늘면 PC 메모리와 CPU도 그만큼 더 듭니다. PC 사양을 보고 정하세요.
3.4 크래시 감지와 자동 재시작
- 서버가 꺼지면 데몬이 이유를 가립니다: 직접 끔, 게임 안에서 끔, 크래시, 이유 모름. 판정 결과는 정보 탭의 최근 종료 기록에 남습니다.
- 크래시로 판정되면 기본적으로 자동으로 다시 켭니다. 5초 뒤 처음 다시 켜고, 다시 켤 때마다 대기 시간이 두 배가 됩니다. 10분 안에 3번을 넘기면 다시 켜기를 멈추므로, 직접 켜야 합니다.
- 사바쨩 탭의 자동 재시작에서 바꿀 수 있습니다.
- 크래시 나면 다시 켜기: 오류로 꺼진 게 확실할 때(기본 켜짐).
- 이유를 모를 때도 다시 켜기: 작업 관리자로 끈 경우처럼 원인을 알 수 없을 때도 포함(기본 꺼짐).
- 사바쨩이나 게임 안에서 직접 끈 경우는 다시 켜지 않습니다.
3.5 메모리 상한 (Windows)
- 사바쨩 탭의 메모리 상한에서 서버와 그 하위 프로세스가 함께 쓸 수 있는 메모리(MB)를 정할 수 있습니다. 상한을 넘으면 서버가 멈춥니다.
- 비우면 제한이 없습니다. Java 서버는
-Xmx보다 1~2GB 크게 잡으세요. - Windows에서만 적용되며, 서버를 다시 시작해야 반영됩니다.
3.6 실행 인자 미리보기
- 게임이 실행 인자를 쓰는 경우, 사바쨩 탭의 실행 인자 미리보기에서 지금 설정으로 서버가 어떤 명령줄로 실행될지 서버를 켜지 않고 확인할 수 있습니다.
- 추가 인자 칸에 설정 화면에 없는 인자(예:
-players=16 -useperfthreads)를 적으면 실행할 때 그대로 넘깁니다. 형식이 틀린 값은 미리보기에서 바로 알려 줍니다. - 비밀번호 같은 값은
***로 가려서 보여 줍니다.
3.7 약관 동의 (Minecraft EULA 등)
- 게임 서버에 동의가 필요한 약관이 있으면, 서버를 만들 때나 처음 켤 때 약관 동의 창이 뜹니다. 원문을 읽고 체크한 뒤 동의하고 켜기를 누르세요.
- 동의는 이 PC의 GUI·CLI에서만 할 수 있습니다. 디스코드에서 켜려는데 동의가 안 되어 있으면 PC에서 먼저 동의해야 합니다.
4. 백업과 예약 작업
백업·예약 탭에서 다룹니다. 예약 작업은 모든 서버에서 쓸 수 있고, 백업 목록과 백업 작업은 백업을 지원하는 게임에서만 보입니다.
4.1 백업
- 지금 백업을 누르면 월드와 세이브 파일을 압축해 둡니다. 저장할 위치는 게임 모듈이 정합니다(예: 마인크래프트는 월드 폴더). 서버가 켜져 있으면 먼저 게임에 저장 명령(마인크래프트
save-all등)을 보냅니다. - 백업 목록에는 종류가 함께 표시됩니다: 직접, 예약, 업데이트 전, 복원 전.
- 복원은 서버를 끈 뒤에 할 수 있습니다. 복원하기 전에 지금 상태를 한 번 더 백업해 두므로, 잘못 고른 백업도 되돌릴 수 있습니다.
- 직접 만든 백업은 자동 정리에서 빠집니다. 나머지(예약·업데이트 전·복원 전) 백업은 예약 백업 보관 개수(기본 10개)까지만 남기고 오래된 것부터 지웁니다.
- 백업 파일은 서버(인스턴스) 폴더 안에 저장됩니다. 서버를 삭제하면 백업도 함께 지워지니, 중요한 백업은 따로 복사해 두세요.
4.2 예약 작업
작업 추가로 정해진 주기(N분마다)나 매일 정해진 시각(HH:MM, PC 시간대)에 다음 작업을 자동으로 실행합니다.
| 작업 | 동작 |
|---|---|
| 백업 | 서버가 켜져 있을 때 백업 |
| 재시작 | 서버가 켜져 있으면 다시 시작 |
| 공지 | 서버가 켜져 있으면 게임 안에 메시지 전송 |
| 업데이트 | 게임 서버 업데이트를 확인하고 있으면 적용 (켜져 있었으면 다시 켬) |
- 재시작·업데이트에는 미리 알림(예:
10, 5, 1분 전)을 걸어 게임 안에 예고할 수 있습니다. 공지와 미리 알림은 게임이 공지 명령을 지원할 때만 쓸 수 있습니다. - 데몬을 다시 켜면 주기 작업은 그때부터 다시 셉니다. 데몬이 꺼져 있던 동안 지나간 시각의 작업은 몰아서 실행하지 않습니다.
5. 친구들이 접속하게 하기
게임 서버는 만들었지만 친구가 들어오지 못한다면 대개 다음 셋 중 하나입니다.
5.1 같은 와이파이(LAN) 친구
별도 설정 없이 서버 PC의 사설 IP(예: 192.168.0.10)와 포트로 접속하면 됩니다.
5.2 외부 친구: 포트포워딩 가능한 공유기
포트포워딩은 바깥에서 온 접속을 서버 PC로 넘기도록 공유기에 정해 두는 설정입니다.
- 공유기 관리 페이지에서 게임 포트를 서버 PC의 사설 IP로 포트포워딩합니다.
- 친구에게
<공인 IP>:<포트>주소를 알려 줍니다. 공인 IP는 whatismyip.com 같은 곳에서 확인합니다. - Windows 방화벽에서 해당 포트의 인바운드(바깥에서 들어오는 접속)를 허용합니다.
5.3 외부 친구: 포트포워딩이 안 되는 환경
학교/회사망, 통신사 CGNAT, 게스트 와이파이 등 포트포워딩이 막힌 환경이라도 서버쨩을 통해 디스코드에서 서버를 켜고 끌 수 있습니다.
- GUI의 디스코드 화면에서 디스코드 서버 연결로 코드를 받아, 디스코드 서버에서
/사바쨩 연결슬래시 명령에 입력합니다. - 이후 친구들은 디스코드에서 서버를 켜고 끄거나 상태를 볼 수 있습니다.
- 자세한 흐름은 디스코드 봇 & 서버쨩를 보세요.
서버쨩은 게임 트래픽이 아니라 제어 명령(시작/정지/상태 등)만 중계합니다. 친구가 게임 서버에 직접 접속할 수 없는 환경이라면 추가 솔루션(예: ZeroTier, Tailscale)을 같이 써야 할 수 있습니다.
6. 디스코드 봇과 함께 쓰기: 한 페이지 요약
봇을 한 번 페어링해 두면 일상 운영의 상당 부분을 GUI를 열지 않고 디스코드에서 끝낼 수 있습니다. 메시지 명령의 기본 형식은 <접두사> <서버> <명령>이고, 기본 접두사는 사바쨩입니다(봇 설정에서 바꿀 수 있습니다). <서버> 자리에는 서버 이름이나 게임 이름(별명)을 씁니다.
| 상황 | 디스코드에서 치는 명령 (기본 접두사 기준) |
|---|---|
| "오늘 마크 켜자" | 사바쨩 마인크래프트 start |
| "지금 서버 켜져 있어?" | 사바쨩 마인크래프트 status |
| "이제 끄자" | 사바쨩 마인크래프트 stop |
| "어떤 서버가 있지?" | 사바쨩 list |
| "뭘 칠 수 있지?" | 사바쨩 help |
서버마다 /<서버 이름> 슬래시 명령도 생깁니다. 전체 명령어 목록과 별명 등록법은 명령어 문서에서 다룹니다.
봇 자체의 셋업·페어링·서버쨩 동작 원리는 디스코드 봇 & 서버쨩를 참고하세요.
7. 업데이트, 정리
7.1 사바쨩 업데이트
- 사바쨩은 서명된 릴리스 목록을 주기적으로 확인하고, 새 버전이 있으면 GUI에 업데이트 사용 가능 알림을 띄웁니다.
- 설정 → 사바 스토리지의 컴포넌트 탭에서 구성요소(본체·모듈·익스텐션 등)별로 내려받고 적용합니다. 본체처럼 실행 중인 파일을 바꿔야 하는 구성요소는 설치 프로그램(
saba-chan-installer)이 데몬을 잠시 종료하고 교체한 뒤, 바뀐 것만 다시 띄웁니다. 데몬만 바뀌었으면 앱 창은 그대로 두고 데몬만 다시 켭니다. - 데몬이 다시 시작되므로 서버를 쓰지 않는 시간에 적용하세요.
7.2 게임 서버 업데이트
- 게임 서버의 새 버전이 있으면 서버 화면에 업데이트 버튼이 나타납니다. 서버를 끈 상태에서 적용할 수 있습니다.
- 업데이트 전에 자동으로 업데이트 전 백업을 만듭니다(백업을 지원하는 게임).
- 예약 작업의 업데이트로 정해진 시각에 자동 적용할 수도 있습니다(§4.2).
7.3 서버 삭제
- 정보 탭의 서버 삭제로 지웁니다. 서버를 끈 다음에만 삭제할 수 있습니다.
- 사바쨩이 내려받아 만든 서버는 서버 폴더(게임 서버 파일, 백업 포함)가 통째로 지워집니다. 필요한 월드나 백업은 먼저 복사해 두세요.
- 기존 서버 가져오기로 연결한 서버는 원래 폴더의 게임 파일이 그대로 남습니다.
7.4 사바쨩 제거
- Windows의 설정 → 앱 → 설치된 앱에서 Saba-chan을 제거합니다.
- 제거기는 켜져 있는 서버를 먼저 정상 종료하고, 설치 폴더와 데이터 폴더(
%APPDATA%\saba-chan\), 바로가기를 지웁니다. 사바쨩이 만든 서버의 파일과 백업도 기본적으로 이 데이터 폴더 안에 있으니, 남겨야 할 월드는 제거 전에 따로 복사해 두세요. 게임 서버 남기기를 체크하면 서버 파일·월드·백업·서버별 설정이, 설정 남기기를 체크하면 앱 설정과 디스코드 연결이 남아 다시 설치했을 때 그대로 이어집니다. 다른 사바쨩 설치가 데이터 폴더를 아직 쓰고 있으면 데이터 폴더는 지우지 않습니다.
8. 문제가 생기면
- 콘솔에 빨간 줄이 뜬다면 일단 그 메시지를 그대로 검색해 보세요. 사바쨩은 게임 서버 자체의 출력을 가공하지 않고 그대로 보여 줍니다.
- 정보 탭의 서버 점검과 로그 진단으로 설정 문제나 최근 로그의 알려진 오류를 확인할 수 있습니다.
- 그래도 안 풀리면 문제 해결 문서에 자주 발생하는 시나리오와 해결 흐름이 정리되어 있습니다.
- 새로운 이슈를 만났다면 GitHub Issues에 콘솔 출력과 함께 올려 주세요. GUI 로그는
%APPDATA%\saba-chan\logs\에 쌓이며, 위쪽의 데몬 상태를 누르면 나오는 창에서 로그 폴더 열기로 바로 열 수 있습니다. 해당 파일을 첨부하면 진단이 빠릅니다.