서버 관리하기

사바쨩으로 게임 서버를 운영하는 일상 워크플로우. 서버 추가·시작·모니터링부터 백업·예약 작업, 친구 초대, 디스코드 연동까지.

서버 관리하기

이 문서는 사바쨩(Saba-chan)을 사용자 입장에서 어떻게 사용하는지 안내합니다. 모듈 코드를 뜯거나 익스텐션을 직접 짜지 않더라도, 이 문서 한 편이면 친구들과 게임할 서버 한두 대를 운영하는 데 충분합니다.

설치는 시작하기에서, 봇 페어링은 디스코드 봇 & 서버쨩에서 다룹니다. 여기서는 이미 설치를 마친 분이 GUI를 열어 두고 무엇을 누르고 무엇을 확인하는지에 집중합니다.


1. 큰 그림: GUI는 리모컨, 서버는 데몬이 돌린다

먼저 알아 둘 점이 있습니다. GUI 창을 닫아도 게임 서버는 꺼지지 않습니다.

  • saba-chan-gui (창): 데몬에 명령을 전달하고 화면에 보여 주는 리모컨. CLI(saba-chan-cli)도 같은 역할을 합니다.
  • saba-core (데몬): 백그라운드에서 게임 서버를 띄우고 감시하는 본체. 서버 실행, 백업, 예약 작업, 디스코드 연결을 모두 데몬이 맡습니다.
  • 게임 서버 프로세스: 데몬이 띄운 실제 서버(java, PalServer.exe 등).

따라서 일상적인 운영은 다음과 같습니다.

  1. GUI를 실행하면 데몬이 같이 뜹니다(이미 떠 있으면 그대로 붙습니다).
  2. 친구들이 들어올 시간에 서버 화면에서 켜기 버튼을 누릅니다.
  3. 게임 중에는 창을 최소화하거나 닫아도 됩니다. 창을 닫으면 인터페이스만 종료(데몬은 계속 실행)와 완전히 종료(데몬까지 종료) 중에서 고릅니다. 서버를 계속 돌리려면 인터페이스만 종료를 고르세요.
  4. 모임이 끝나면 GUI를 다시 열어 끄기 버튼을 누릅니다.

PC를 끄면 게임 서버도 같이 꺼집니다. 데몬은 사용자 PC에서만 동작하므로, 24시간 운영이 필요하면 별도 호스팅을 쓰는 편이 낫습니다.


2. 첫 서버 만들기 (간단 요약)

자세한 설치 과정은 시작하기를 참고하세요. 요약하면:

  1. 서버 화면의 서버 추가 버튼을 누릅니다.
  2. 새 서버 만들기를 고릅니다. 쓰던 서버 폴더가 있다면 기존 서버 가져오기로 연결할 수 있습니다(파일은 원래 자리에 남습니다).
  3. 게임(Minecraft / Palworld / Project Zomboid / Terraria 등)을 고르고, 서버 이름과 추천 설정을 정합니다.
  4. 게임에 약관이 있으면 여기서 동의합니다. 예를 들어 마인크래프트는 Minecraft EULA에 동의해야 서버를 켤 수 있습니다(§3.7).
  5. 서버 추가를 누르면 서버 파일을 자동으로 내려받고, 진행률이 서버 화면에 표시됩니다.
  6. 설치가 끝나면 서버가 목록에 추가됩니다.

서버 이름은 "친구들과 보내는 마인크래프트", "주말 좀보이드"처럼 자유롭게 정해도 됩니다. 디스코드 명령에서는 서버 이름이나 게임 이름(별명)으로 서버를 가리킬 수 있습니다. 이름은 서버가 꺼져 있을 때 이름 옆 연필 버튼으로 바꿀 수 있습니다.


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로 넘기도록 공유기에 정해 두는 설정입니다.

  1. 공유기 관리 페이지에서 게임 포트를 서버 PC의 사설 IP로 포트포워딩합니다.
  2. 친구에게 <공인 IP>:<포트> 주소를 알려 줍니다. 공인 IP는 whatismyip.com 같은 곳에서 확인합니다.
  3. 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\에 쌓이며, 위쪽의 데몬 상태를 누르면 나오는 창에서 로그 폴더 열기로 바로 열 수 있습니다. 해당 파일을 첨부하면 진단이 빠릅니다.