Stardew Server - Docker 一键部署星露谷物语开联机服务器
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 。