Puppy Stardew Server - Docker 一键部署星露谷物语专用服务器

开源了一个基于 Docker 的星露谷物语服务器一键部署解决方案。

项目地址: https://github.com/truman-world/puppy-stardew-server

核心特性

这个项目最大的亮点是整合了几个自定义模组，带来了更好的多人游戏体验：

即时睡眠功能：任何一个玩家在床上选择睡觉，游戏会立刻为所有在线玩家存档并结束当天。再也不用互相等待离线或 AFK 的玩家。

24/7 专用服务器：基于 Docker 容器化，服务器可以 7x24 小时独立运行，房主无需在线。适合部署在 VPS 、云服务器或家用 NAS 上。

一键脚本部署：一条命令，3 分钟即可完成所有环境配置和启动。无需手动安装 SMAPI 、配置模组或设置环境。

跨平台联机：支持 PC 、Mac 、Linux ，以及 iOS 和 Android 玩家在同一个服务器中游戏。所有平台互通，无需复杂配置。

房主自动隐藏：主机玩家作为服务器运行，在游戏中自动隐身，不占用玩家名额，也不会干扰正常游戏。

存档自动加载：服务器重启后会自动加载最新的存档，无需手动操作。首次部署通过 VNC 创建存档后，之后完全自动化。

内置 VNC：首次创建世界时，可以通过浏览器或 VNC 客户端远程访问图形界面，操作简单。

自然技能升级（ v1.0.58 新增）：防止服务器强制房主升到 10 级，保持基于真实经验值的技能等级。玩家可以手动选择技能专精路线，保留游戏原有的成长乐趣。

一键启动

在任何一台安装了 Docker 的服务器上运行：

curl -sSL https://raw.githubusercontent.com/truman-world/puppy-stardew-server/main/quick-start.sh | bash 

脚本会自动完成环境检查、配置文件生成、目录创建、权限设置和容器启动。

手动部署

如果你更喜欢手动控制：

1. 创建 docker-compose.yml

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_USERNAME=your_steam_username - STEAM_PASSWORD=your_steam_password - ENABLE_VNC=true - VNC_PASSWORD=stardew123 ports: - "24642:24642/udp" - "5900:5900/tcp" 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 

2. 设置权限并启动

mkdir -p data/{saves,game,steam} chown -R 1000:1000 data/ docker compose up -d 

3. 首次设置

使用 VNC 连接到 your-server-ip:5900（密码：stardew123），创建或导入存档。

4. 玩家连接

游戏中：Co-op → Join LAN Game → 输入 your-server-ip:24642

预装模组

• SMAPI 4.3.2 - 官方模组加载器
• Always On Server v1.20.3 - 无头服务器运行
• Skill Level Guard v1.4.0 - 防止强制升级，保持自然技能进度
• ServerAutoLoad v1.2.1 - 自动加载存档
• AutoHideHost v1.2.2 - 隐藏房主，即时睡眠

系统要求

服务器端：

• Docker 和 Docker Compose
• 2GB 内存（ 4+ 玩家推荐 4GB ）
• 2GB 磁盘空间
• Steam 账号（拥有星露谷物语）

客户端：

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

v1.0.58 更新

修复：

• Always On Server 自动启用问题（服务器现在可以自动暂停/恢复）
• 玩家技能专精选择问题（可以手动选择路线）

改进：

• 自然技能升级（基于真实经验值，不再强制 10 级）
• 服务器空闲时自动暂停（节省资源）

已解决的问题：

• 长时间空闲后无法连接
• 地震等特殊事件冻结游戏
• 无限等待其他玩家
• 无需邀请码（直接用 IP 连接）

文档与支持

• GitHub: https://github.com/truman-world/puppy-stardew-server
• Docker Hub: https://hub.docker.com/r/truemanlive/puppy-stardew-server
• 完整文档: README.md
• 中文文档: README_CN.md
• 问题反馈: GitHub Issues

许可证

• 项目: MIT License
• 游戏: 需合法拥有星露谷物语（ Steam ）
• SMAPI & Always On Server: GPL-3.0
• 自定义模组: MIT License

如果觉得有用，欢迎给项目点个 Star 。