一个面向《星露谷物语》联机的 Docker 化无人值守服务器项目。

这个项目的目标很明确：尽量把原本复杂、容易踩坑的联机服部署流程，收敛成一套更稳定、更适合长期挂机运行的方案。现在它已经不只是“能跑起来”，而是补齐了 Web 管理面板、存档管理、模组管理、配置修改、日志查看、备份和首次初始化流程。

如果你想要的是：

• 在 Linux 服务器上长期挂一个星露谷联机服

• 尽量少碰复杂的手动 VNC 操作

• 能通过浏览器管理存档、模组、备份和运行状态

• 希望部署流程尽可能简单

那这个项目现在已经比较适合直接上手了。

项目地址

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

• Release: https://github.com/truman-world/puppy-stardew-server/releases/tag/v1.0.77

• Docker Hub: truemanlive/puppy-stardew-server:v1.0.77

目前已经支持的核心功能

1. 一键部署

提供一键脚本，自动完成：

• 环境检查

• 目录初始化

• 配置文件生成

• Docker 服务启动

• Steam 下载流程引导

现在的一键脚本也已经改成更符合真实使用习惯的流程，不再强依赖第一次先连 VNC 手工创建存档。

2. Web 管理面板

Web 面板已经从“简单状态页”升级成了真正可用的管理后台，支持：

• 首次访问设置管理密码

• 中英文界面

• 亮色 / 暗色模式

• 仪表盘状态查看

• 配置修改

• 存档管理

• 模组管理

• 日志查看

• 终端 / SMAPI 控制台

顶部还加了 GitHub 快捷入口，方便直接跳转项目页。

3. 存档管理

现在存档相关能力已经比较完整：

• 上传存档压缩包

• 自动识别并解压合法存档

• 选择默认自动加载存档

• 备份当前存档

• 下载备份到本地

• 备份进度持久化显示

这意味着第一次部署时，不一定非要先进 VNC 手动创建存档。你完全可以直接上传已有存档，然后设为默认存档，重启后自动进入。

4. 模组管理

支持在 Web 面板里：

• 上传自定义 SMAPI 模组

• 删除自定义模组

• 查看模组列表

• 显示更明确的上传 / 删除结果提示

之前自定义模组上传和删除的挂载权限、识别逻辑、前端交互问题也已经修过了。

5. 运行配置可直接在面板修改

很多常用配置现在都可以直接在 Web 面板修改并保存，包括：

• Steam 账号

• Steam 密码

• Public Join IP

• SAVE_NAME

• 低性能模式

• 目标 FPS

• 自动备份

• 最大备份数

• 备份时间

• 备份压缩级别

• 崩溃自动重启

• 最大重启次数

• VNC 开关

而且保存后已经不是“只写文件不生效”，现在面板可以触发真实容器级重启 / 重建流程。

6. 更适合长期运行的服务器能力

项目现在已经补齐了不少长期运行需要的东西：

• 崩溃自动重启

• 状态上报

• Prometheus 指标

• 仪表盘详情显示

• 分类日志

• 自动化脚本健康状态

• 玩家在线状态统计

对外联机时，仪表盘也会显示更明确的联机 IP 、联机端口和其他运行信息。

7. 日志与排障体验改进

日志页不再只有一份总日志，已经支持：

• 全部日志

• 错误日志

• 模组日志

• 服务器日志

• 游戏日志

相关分类逻辑、路径读取和回退解析也做过修复，减少“明明有日志但页面空白”的情况。

8. 更适合低性能机器

项目现在有专门的低性能模式，支持：

• 降低分辨率

• 降低色深

• 降低目标 FPS

• 调整部分 Mono / .NET 参数

• 降低备份压缩带来的 CPU 峰值

另外也补了 headless 音频 / OpenAL 默认兜底，减少纯 Docker 环境下的启动报错噪音。

最近这轮更新重点

这一轮版本主要可以概括成几件事：

• 把“首次必须进 VNC 手工初始化”的流程，尽量改成“优先通过 Web 面板完成”

• 把 Web 面板从展示型页面，补成真正能管理服务器的后台

• 把存档、模组、配置、日志这些高频操作收拢到浏览器里完成

• 把一些真实使用中会遇到的坑逐个修掉，比如：

• 配置保存后不生效

• VNC 关闭后仍暴露

• 自定义模组上传 / 删除失败

• 分类日志不准

• 在线玩家统计异常

• 状态 JSON 写坏

适合哪些人

• 想在 VPS / 家用 Linux 机器上挂星露谷联机服的人

• 不想每次都进桌面手动点来点去的人

• 想把存档、模组、备份和配置放到浏览器里管理的人

• 想做长期在线服，而不是临时开房的人

截图位置

这里你可以自己插入项目截图，例如：

• 登录页

• 仪表盘

• 存档管理页

• 模组管理页

使用方式

一键脚本

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

中文脚本：

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

Docker 镜像

docker pull truemanlive/puppy-stardew-server:v1.0.77

反馈与问题提交

如果你在使用过程中遇到问题，或者希望增加新功能，欢迎直接提 Issues：

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

提交问题时如果能附上这些内容，会更容易排查：

• 运行环境

• 使用的版本号

• 错误日志

• 复现步骤

• 是否使用了自定义模组

最后

这个项目现在已经不是单纯的“Docker 跑个星露谷进程”，而是在尽量朝一个真正可维护、可观察、可管理的长期在线联机服方案走。

如果你也想要一个更省心的《星露谷物语》无人值守服务器，欢迎试用、提建议、提 Issues 。