[Docker] 스타듀밸리 headless 서버 만들기

빙기·2026년 3월 19일

홈서버 구축기

목록 보기
2/2
post-thumbnail

주니모 서버를 사용해 개인 우분투 서버에 스타듀밸리 모드 서버를 개설했습니다.

설치 방법

주니모 서버 설치 방법에 따라 설치를 진행했습니다.

mkdir junimoserver && cd junimoserver
curl -O https://raw.githubusercontent.com/stardew-valley-dedicated-server/server/master/docker-compose.yml
curl -O https://raw.githubusercontent.com/stardew-valley-dedicated-server/server/master/.env.example
mv .env.example .env

.env 파일에는 스팀 아이디, 비밀번호와 서버 관리 웹 비밀번호를 입력해야 합니다.

STEAM_USERNAME="your_steam_username"
STEAM_PASSWORD="your_steam_password"
VNC_PASSWORD="your_secure_password"

이후 스팀 로그인 진행합니다.

docker compose run --rm -it steam-auth setup

실행하면 이런 오류가 발생했습니다.

Image sdvd/steam-service:latest failed to resolve reference "docker.io/sdvd/steam-service:latest": docker.io/sdvd/steam-service:latest: not found 
Image sdvd/steam-service:latest Building 
[+] Building 0.1s (1/1) FINISHED                                                                                       
 => [internal] load local bake definitions                                                                        0.0s
 => => reading from stdin 581B                                                                                    0.0s
unable to prepare context: path "/home/jmt/docker/junimo-server/tools/steam-service" not found

이슈가 있어 버전을 latest에서 preview로 변경하면 해결된다는 것을 확인했습니다.

이미지를 -latest에서 -preview로 변경 후 다시 스팀 로그인합니다.

docker compose run --rm -it steam-auth setup

로그인 진행 후 바로 게임 파일 다운로드까지 진행됩니다

게임 파일 설치가 됐습니다. 이제 도커로 서버를 열겠습니다.

docker compose up -d

잘 열린 것을 확인할 수 있습니다.

docker compose exec server attach-cli

다음으로 서버 농장의 초대코드를 받습니다.

빨간색 위치에 적힌 코드가 바로 초대코드입니다. 해당 화면에서 서버에 커맨드라인으로 명령어를 입력할 수 있습니다.

잘 들어가지는 것을 확인할 수 있습니다.

+) 모바일(안드로이드) 접속 시도 (실패)

외부 접근까지 생각해서 tailscale로 연결된 휴대전화에서 접속을 시도했습니다.
vpn으로 접속 성공한 기록, pc와 모바일 통신 성공한 기록을 참고했습니다.

환경:

  • 서버 pc와 스마트폰은 tailscale에 연결되어있음.
  • 스마트폰의 스타듀밸리 버전 1.6.15.1, PC 스타듀밸리도 1.6.15 버전
  • 같은 와이파이 사용중 (이건 tailscale로 연결되어 있다면 사실상 필요 없음)

트러블슈팅

  1. 같은 와이파이에 연결되어 있으므로 서버의 ip로 통신을 시도: 실패
  2. tailscale의 서버 pc ip로 통신을 시도: 실패
  3. exit node를 서버 pc로 설정 후 서버 pc ip로 통신을 시도: 실패
  4. tailscale 서버 pc ip + 포트 (24642) 명시: 실패

일단 시도했던 것은 전부 실패했습니다. 마이너 버전이 달라서 통신이 안될 가능성 있습니다.
계속 사용해보며 성공하면 업데이트 예정입니다.

0개의 댓글