truemanlive/puppy-stardew-server

Puppy Stardew Server

基于Docker的星露谷物语专用服务器，支持全平台多人联机。

一键部署星露谷物语专用服务器，支持全平台联机

快速开始

步骤1：创建docker-compose.yml

yaml
version: '3.8'
services:
  stardew-server:
    image: truemanlive/puppy-stardew-server:latest
    container_name: puppy-stardew
    restart: unless-stopped
    stdin_open: true
    tty: true
    environment:
      # 必填：你的Steam凭据
      - STEAM_USERNAME=你的Steam用户名
      - STEAM_PASSWORD=你的Steam密码
      # 可选：用于初始设置的VNC
      - ENABLE_VNC=true
      - VNC_PASSWORD=stardew123
    ports:
      - "24642:24642/udp"  # 游戏端口（必填）
      - "5900:5900/tcp"    # VNC端口（可选）
    volumes:
      - ./data/saves:/home/steam/.config/StardewValley:rw
      - ./data/game:/home/steam/stardewvalley:rw
      - ./data/steam:/home/steam/Steam:rw
    deploy:
      resources:
        limits:
          cpus: '2.0'
          memory: 2G
        reservations:
          memory: 1G

步骤2：设置目录权限（重要）

数据目录必须由UID 1000拥有：

bash
mkdir -p data/{saves,game,steam}
chown -R 1000:1000 data/

步骤3：启动服务器

bash
docker compose up -d
docker logs -f puppy-stardew

步骤4：初始设置（仅首次运行）

1. 通过你的服务器IP:5900连接VNC（密码：stardew123）
2. 创建或加载存档文件
3. 完成！服务器将在未来重启时自动加载此存档

玩家现在可以通过以下方式连接：游戏 → 合作 → 加入局域网游戏 → 你的服务器IP:24642

核心功能

• 一键部署 - docker compose up -d即可完成部署
• 全平台支持 - 支持PC、Mac、Linux、iOS、Android
• 24/7专用服务器 - 独立运行，无需主机玩家干预
• 自动加载存档 - 服务器重启时自动加载存档
• 资源高效 - 仅需2GB内存即可流畅运行
• VNC远程访问 - 内置VNC便于首次设置
• 即时睡眠 - 玩家可随时睡眠，无需等待他人
• 隐藏主机 - 主机玩家自动隐藏，提供无缝游戏体验
• 自然技能 progression - 防止强制等级10，保留真实经验值基础的等级提升

要求

服务器端

• 已安装Docker和Docker Compose
• 最低2GB内存（4+玩家建议4GB）
• 2GB磁盘空间
• 已购买星露谷物语的Steam账户（用于游戏下载）

客户端

• 星露谷物语（任何平台）
• 与服务器相同的游戏版本

配置

环境变量

端口

• 24642/udp - 游戏服务器端口（必填，必须在防火墙中开放）
• 5900/tcp - VNC端口（可选，仅用于初始设置）

卷挂载

• ./data/saves → /home/steam/.config/StardewValley - 存档文件和模组配置
• ./data/game → /home/steam/stardewvalley - 游戏安装目录
• ./data/steam → /home/steam/Steam - Steam缓存和元数据

使用绑定挂载使备份变得简单：tar -czf backup.tar.gz data/saves/

常用命令

bash
# 查看实时日志
docker logs -f puppy-stardew

# 重启服务器
docker compose restart

# 停止服务器
docker compose down

# 更新到最新版本
docker compose pull
docker compose up -d

# 备份存档
tar -czf backup-$(date +%Y%m%d).tar.gz data/saves/

# 附加容器以输入Steam Guard验证码
docker attach puppy-stardew
# 输入验证码，然后按Ctrl+P Ctrl+Q分离（不要按Ctrl+C）

预装模组

所有模组均已预配置，可直接使用：

1. SMAPI 4.3.2

官方星露谷物语模组API。

• 作者：Pathoschild
• 许可证：GPL-3.0
• 用途：所有其他模组的基础

2. Always On Server v1.20.3

支持无头24/7服务器运行。

• 作者：funny-snek & Zuberii
• 许可证：GPL-3.0
• 用途：为专用服务器自动执行主机玩家活动

3. Skill Level Guard v1.4.0（自定义）

防止Always On Server强制主机等级为10级。

• 用途：维持基于真实经验值的技能等级提升
• 特性：
  • 阻止强制等级10的API调用
  • 根据实际经验值恢复真实技能等级
  • 自动启用Always On Server的自动模式
  • 不干扰正常游戏

4. ServerAutoLoad v1.2.1（自定义）

容器重启时自动加载存档文件。

• 用途：初始设置后无需VNC
• 特性：
  • 启动时自动加载上次游玩的存档
  • 自动检测存档文件
  • 无需手动干预

5. AutoHideHost v1.2.2（自定义）

隐藏主机玩家并启用即时睡眠。

• 用途：提供无缝多人游戏体验
• 特性：
  • 主机自动传送到沙漠（对玩家不可见）
  • 所有在线玩家准备好后即时睡眠
  • 无需等待离线/AFK玩家
  • 玩家可手动选择技能职业（v1.2.2+）

故障排除

游戏下载时出现"Disk write failure"

原因：数据目录未由UID 1000拥有

解决方法：

bash
chown -R 1000:1000 data/
docker compose restart

需要Steam Guard验证码

bash
docker attach puppy-stardew
# 输入来自邮件/移动应用的Steam Guard验证码
# 按Ctrl+P Ctrl+Q分离（不要按Ctrl+C！）

玩家无法连接

1. 检查防火墙允许UDP端口24642：sudo ufw allow 24642/udp
2. 验证容器是否运行：docker ps | grep puppy-stardew
3. 确认存档已加载：通过VNC连接或检查日志
4. 确保服务器和客户端游戏版本匹配

VNC无法连接

1. 验证TCP端口5900是否可访问
2. 检查VNC密码是否正确（最多8个字符）
3. 尝试不同的VNC客户端（RealVNC、TightVNC等）
4. 查看日志：docker logs puppy-stardew | grep -i vnc

内存占用过高

编辑docker-compose.yml调整资源限制：

yaml
deploy:
  resources:
    limits:
      memory: 1.5G  # 如需可从2G减少

性能基准

典型资源使用

• CPU：活跃游戏时1-2核
• 内存：2-4名玩家时1.5-2GB
• 磁盘：约1.5GB游戏文件+存档数据
• 网络：低带宽（<1 Mbps）

按玩家数量推荐配置

• 1-4名玩家：2GB内存，1个CPU核心
• 4-8名玩家：4GB内存，2个CPU核心
• 8名以上玩家：4GB以上内存，2个以上CPU核心

支持的平台

服务器（Docker主机）

• Linux（x86_64）- 原生性能
• Windows（Docker Desktop）- 完全支持
• macOS（Docker Desktop）- 完全支持

客户端（游戏玩家）

• PC（Windows、macOS、Linux）
• iOS（星露谷物语移动版）
• Android（星露谷物语移动版）

跨平台游戏无缝支持 - iOS/Android玩家可加入PC托管的服务器，无兼容性问题。

重要说明

***要求

你必须在Steam上拥有星露谷物语。此Docker镜像不包含游戏文件 - 首次启动时通过你的Steam账户使用SteamCMD（AppID 413150）下载。

安全最佳实践

• 使用强Steam密码
• 修改默认VNC密码
• 初始设置后禁用VNC：ENABLE_VNC=false
• 保持镜像更新：docker compose pull
• 不要将VNC端口（5900）暴露到公共互联网
• 如需远程VNC访问，使用SSH隧道

隐私与凭据

你的Steam凭据：

• 仅存储在本地的.env文件中
• 仅用于通过SteamCMD下载游戏文件
• 仅传输到官方Steam服务器
• 首次下载成功后可移除

版本历史

v1.0.58（2025年11月）- 最新

• 更新：Skill Level Guard v1.4.0 - 修复Always On Server自动启用问题
• 改进：基于反射的实例捕获，提高稳定性
• 增强：与Always On Server v1.20.3的兼容性

v1.0.57（2025年11月）

• 更新：AutoHideHost v1.2.2 - 禁用LevelUpMenu自动处理
• 修复：玩家现在可手动选择技能职业
• 改进：保留自然角色 progression

v1.0.56（2025年11月）

• 更新：AutoHideHost v1.2.1 - 稳定性改进
• 增强：Guard窗口机制可靠性

v1.0.40-v1.0.55（2025年11月）

• 性能优化
• VNC改进
• Guard窗口机制开发
• Always On Server自动启用修复

v1.0.22-v1.0.39（2025年10月）

• 修复：容器重启循环bug
• 改进：Steam Guard标准输入处理
• 增强：VNC密码验证
• 添加：ServerAutoLoad模组
• 添加：AutoHideHost模组

v1.0.0（2025年10月）

• 初始版本
• 一键部署
• 跨平台支持
• VNC远程访问
• 基本模组集成

文档与支持

• GitHub仓库：https://github.com/truman-world/puppy-stardew-server
• 完整文档：完整设置指南和高级配置
• bug报告：https://github.com/truman-world/puppy-stardew-server/issues
• Docker Hub：https://hub.docker.com/r/truemanlive/puppy-stardew-server

credits

• 星露谷物语 by ConcernedApe
• SMAPI by Pathoschild
• Always On Server by funny-snek & Zuberii
• Docker by Docker, Inc.
• 自定义模组 by truman-world & AI Developer

许可证

• 项目：MIT许可证 - 可免费使用、修改和分发
• 游戏：你必须在Steam上合法拥有星露谷物语
• SMAPI：GPL-3.0
• Always On Server：GPL-3.0
• 自定义模组（ServerAutoLoad、AutoHideHost、Skill Level Guard）：MIT

为星露谷物语社区制作

GitHub：https://github.com/truman-world/puppy-stardew-server