荔枝相册完整使用指南:Docker部署与私有化照片管理实战
荔枝(Lychee)是一款开源且免费的照片管理工具,设计用于在您自己的服务器或网络存储空间上独立运行。它提供了媲美本地应用程序的完整体验,支持照片的上传、组织管理与共享。该工具集成了您所需的核心功能,并确保所有照片数据均安全地存储于您掌控的环境中。

您可以通过在线演示环境预先体验其功能: https://lychee-demo.fly.dev
部署安装:通过Docker Compose快速搭建
最便捷的部署方式是使用 Docker Compose。以下是一个完整的配置示例,您可以根据自己的网络环境调整参数。
services:
lychee:
image: lycheeorg/lychee:latest
container_name: lychee
ports:
- 8080:80
environment:
- PUID=1000
- PGID=1000
- PHP_TZ=Asia/Shanghai
- TIMEZONE=Asia/Shanghai
- APP_URL=http://192.168.31.90:8080
- DB_CONNECTION=mysql
- DB_HOST=lychee_db
- DB_PORT=3306
- DB_DATABASE=lychee
- DB_USERNAME=user
- DB_PASSWORD=password
volumes:
- ./conf:/conf
- ./uploads:/uploads
- ./sym:/sym
restart: unless-stopped
lychee_db:
image: mariadb:10
container_name: lychee_db
environment:
- MYSQL_ROOT_PASSWORD=rootpassword
- MYSQL_DATABASE=lychee
- MYSQL_USER=user
- MYSQL_PASSWORD=password
volumes:
- ./mysql:/var/lib/mysql
restart: unless-stopped
核心环境变量参数说明
为了确保服务正常运行,以下是对关键环境变量的简要解释(建议部署前查阅官方文档以获取最全面的信息)。
:::tips
- PUID(可选):用于设置容器内运行进程的用户ID,关系到文件权限。
- PGID(可选):用于设置容器内运行进程的用户组ID。
- PHP_TZ:配置PHP运行时使用的时区。
- TIMEZONE:设置系统时区。
- APP_URL:这是最重要的参数之一,需要配置为Lychee应用最终被访问的完整URL地址,请根据您的实际网络情况修改。
- DB_CONNECTION:指定数据库类型,例如mysql。
- DB_HOST:数据库服务的主机地址,在Compose网络中通常使用服务名。
- DB_PORT:数据库服务的连接端口。
- DB_DATABASE:指定要连接的数据库名称。
- DB_USERNAME:拥有上述数据库访问权限的用户名。
- DB_PASSWORD:对应用户的数据库访问密码。 :::
使用指南:从初始化配置到日常操作
完成部署后,在浏览器地址栏输入 http://您的服务器IP:8080 即可访问Lychee的Web界面。
闲置NAS变自动赚钱机:青龙面板部署与B站脚本薅羊毛全攻略
青龙面板(Qinglong)是一款功能强大的定时任务管理平台,它能够支持多种脚本语言,包括Python3、JavaScript、Shell和Typescript。通过将青龙面板部署在闲置的NAS设备上,用户可以自动化运行各种脚本任务,从而探索潜在的收益机会,实现设备的充分利用。

该平台具备一系列实用功能:
- • 兼容多种脚本语言,例如python3、javaScript、shell和typescript。
- • 提供在线管理脚本、环境变量和配置文件的能力。
- • 支持在线查看任务执行日志,方便监控和调试。
- • 允许设置秒级精度的定时任务。
- • 集成系统级通知机制,及时反馈任务状态。
- • 提供暗黑模式界面,适应不同用户的视觉偏好。
- • 优化手机端操作体验,实现随时随地管理任务。
部署青龙面板
通过Docker Compose可以快速部署青龙面板。以下是具体的配置示例:
services:
qinglong:
image: whyour/qinglong:latest
container_name: qinglong
ports:
- 5700:5700
volumes:
- ./data:/ql/data
restart: unless-stopped
青龙面板配置与使用指南
在浏览器地址栏中输入 http://NAS的IP:5700 即可访问青龙面板的初始化界面。

进入界面后,点击“开始安装”按钮以启动安装流程。

系统会提示配置通知方式,用户可以根据个人需求选择设置或直接跳过此步骤。

接下来需要设置管理员的用户名和密码,请务必牢记这些凭据。

初始化过程完成后,点击“去登录”选项进入登录页面。

在登录页面输入之前设置的用户名和密码。

成功登录后,用户将进入青龙面板的主控制界面。

请注意:脚本的来源需要用户自行通过搜索引擎寻找,本文仅以bilibili脚本为例进行演示。不同脚本的操作步骤可能有所差异。
首先进入配置文件界面,修改config.sh文件。

找到名为RepoFileExtensions的参数,确保其值包含“js py sh”这三种文件后缀。

完成设置后,点击右上角的保存按钮以应用更改。

接下来进入订阅管理模块,创建一个用于拉取脚本仓库的订阅任务。

参考以下配置信息填写并创建订阅:
名称:Bilibili
类型:公开仓库
链接:https://github.com/RayWangQvQ/BiliBiliToolPro.git
定时类型:crontab
定时规则:2 2 28 * *
白名单:bili_task_.+\.sh
文件后缀:sh

零成本部署:基于Docker的免费CAD工作站完整指南
FreeCAD 是一款遵循 LGPL 开源协议的参数化三维 CAD 建模软件。它主要服务于机械工程与产品设计领域,同时其功能也延伸至建筑、有限元分析以及三维打印等应用场景。该软件提供了与 CATIA、SolidWorks 等商业软件相类似的核心建模能力。
安装部署步骤
使用 Docker Compose 部署
通过 Docker Compose 可以快速配置并启动 FreeCAD 服务。以下是一份标准的部署配置文件示例:
services:
freecad:
image: linuxserver/freecad:latest
container_name: freecad
ports:
- 3000:3000
- 3001:3001
environment:
- PUID=1000
- PGID=1000
- TZ=Asia/Shanghai
volumes:
- ./config:/config
shm_size: "1gb"
restart: unless-stopped
关键配置参数解读
为了帮助理解,下面对配置中的部分参数进行简要说明(更详细的配置建议查阅官方文档):
- PUID (环境变量,可选):用于设置容器内运行进程的用户标识符(UserID),关联文件权限。
- PGID (环境变量,可选):用于设置容器内运行进程的用户组标识符(GroupID),同样与权限管理相关。
- TZ (环境变量):设定容器系统的时区,例如
Asia/Shanghai代表东八区北京时间。 - /config (卷映射路径):此路径用于持久化保存 FreeCAD 的配置文件和个人数据。
- shm_size (容器参数):用于设置共享内存的大小,对于图形应用,适当增加此值有助于提升性能。
基本操作与界面导览
成功部署后,在网页浏览器的地址栏输入 https://你的NAS_IP地址:3001 即可访问 FreeCAD 的 Web 界面。请注意,此服务默认使用 HTTPS 安全协议。

首次进入时,您可以在设置中将界面语言切换为中文,以获得更友好的操作体验。

软件提供了多种视觉主题可供选择,用户可以根据个人偏好进行切换。经典的深色主题在长时间工作时可能对眼睛更为友好。
零显卡需求:在NAS上私有化部署MTranServer离线翻译服务全指南
MTranServer是一款资源消耗极低、响应速度极快的离线翻译服务器,其最大特点在于完全无需独立显卡支持。单个翻译请求的平均响应时间可控制在50毫秒以内。该服务支持全球范围内主要语言之间的互译,为用户提供了一个高效、本地的翻译解决方案。
下图展示了MTranServer与其他同类项目在仅使用CPU进行英译中任务时的效果对比。


重要提示: 当前最新版本可能存在内存泄漏问题。一个可行的解决方案是手动下载并使用2.1.1版本的模型文件。关于此问题的最终修复时间,请关注项目在GitHub上的官方公告。为了简化演示流程,本文仍将使用最新的镜像版本进行说明。
安装部署步骤
推荐使用 Docker Compose 方式进行部署,以下是一个基础的配置示例:
services:
mtranserver:
image: xxnuo/mtranserver:latest-zh
container_name: mtranserver
ports:
- 8989:8989
environment:
- CORE_API_TOKEN=your_token
restart: unless-stopped
关键参数说明(更多高级配置建议查阅官方文档):
CORE_API_TOKEN(环境变量,可选):用于保护API访问的密码,请务必修改为自己设定的复杂字符串。/app/models(卷挂载路径,可选):此路径用于存放翻译模型文件,如果希望持久化模型或使用特定版本,可以将其挂载到宿主机目录。
服务配置与使用指南
完成部署后,在浏览器地址栏中输入 http://你的NAS_IP地址:8989/docs 即可访问完整的API交互式文档。

须知:MTranServer本身不提供图形化的用户界面,所有功能均通过调用其提供的API接口来实现。

该服务为多种应用场景提供了专用的API端点。

接下来介绍如何通过流行的浏览器插件“沉浸式翻译”来调用此API。首先,根据你的浏览器下载对应的插件:
- Microsoft Edge 用户: https://microsoftedge.microsoft.com/addons/detail/%E6%B2%89%E6%B5%B8%E5%BC%8F%E7%BF%BB%E8%AF%91-%E7%BD%91%E9%A1%B5%E7%BF%BB%E8%AF%91%E6%8F%92%E4%BB%B6-pdf%E7%BF%BB%E8%AF%91-/amkbmndfnliijdhojkpoglbnaaahippg?hl=zh-CN
- Google Chrome 用户: https://chromewebstore.google.com/detail/%E6%B2%89%E6%B5%B8%E5%BC%8F%E7%BF%BB%E8%AF%91-%E7%BD%91%E9%A1%B5%E7%BF%BB%E8%AF%91%E6%8F%92%E4%BB%B6-pdf%E7%BF%BB%E8%AF%91-%E5%85%8D%E8%B4%B9/bpoadfkcbjbfhfodiogcnhhhpibjhbnh?hl=zh-CN&utm_source=ext_sidebar
安装完成后,即可在浏览网页时使用该插件进行内容翻译。

插件安装并启用后,页面通常会出现一个悬浮的翻译控制按钮。

点击该按钮以打开设置面板。

在面板中选择进入“设置”菜单。

将页面滚动至底部,找到并启用“Beta测试特性”选项。

在此部分,可以添加自定义的翻译服务(插件本身也提供免费的在线翻译服务)。

在服务类型中,选择最后一项“自定义API”。

配置提示:如果在Docker部署时设置了CORE_API_TOKEN环境变量,则需要在API地址的末尾附加查询参数,格式为 ?token=你设置的token值。
参考配置示例如下:
- 服务名称:
MTranServer - 服务器地址:
http://192.168.31.90:8989/imme?token=your_token

高级参数可以设置为:每秒最大请求数5000,每次请求最大段落数10,这足以满足个人高频使用。

点击“测试服务”按钮,若显示绿色对勾或成功提示,则表明与自建翻译服务器的连接配置正确。

测试成功后,将新添加的“MTranServer”服务设为默认的翻译引擎。

现在,访问任意英文网站,点击沉浸式翻译的图标,即可使用您自己部署的离线服务器进行翻译。

在典型的翻译负载下,其资源占用情况如图所示:CPU使用率峰值通常在17%以下,内存占用大约为400MB(请注意,由于当前版本存在已知的内存泄漏问题,实际占用可能缓慢增长;待修复后,内存占用预期会更低且更稳定)。
Abs-Ximalaya:一站式解决Audiobookshelf喜马拉雅有声书元数据难题
本教程旨在提供一个有效的解决方案。如果在实践中遇到任何问题或有更好的建议,欢迎通过文末留言与我们交流。
如果这篇教程对您有所帮助,也欢迎通过“点赞”给予鼓励或通过“打赏”表示支持。
在管理本地的喜马拉雅有声书资源时,我们常常会遇到元数据获取困难的挑战。Abs-Ximalaya 正是为此而生的一个工具,它作为 Audiobookshelf 的元数据提供商,专门用于从喜马拉雅平台刮削和提供丰富、准确的有声书信息。

关联教程: 如果您尚未搭建 Audiobookshelf 服务器,可以参考这篇教程:Audiobookshelf 有声书与播客服务器
如何安装与部署
推荐使用 Docker Compose 进行部署,这是最为简便快捷的方式。您只需创建一个 docker-compose.yml 文件,并填入以下配置即可。
Docker Compose 配置文件
services:
ximalaya:
image: shanyanwcx/abs-ximalaya:latest
container_name: ximalaya
ports:
- 7814:7814
environment:
- TZ=Asia/Shanghai
restart: always
配置完成后,在终端中运行 docker-compose up -d 命令,服务便会启动。
具体使用步骤详解
-
访问服务界面 部署成功后,在浏览器地址栏中输入
http://你的NAS或服务器IP:7814。如果看到提示界面,说明服务已正常运行。
-
配置 Audiobookshelf 打开您的 Audiobookshelf 有声书管理服务器。

进入“设置” -> “项目元数据管理” -> “自定义元数据提供商”。

点击“添加”按钮来创建一个新的提供商。

请参考下图进行设置。关键点在于“名称”可自定义(如“喜马拉雅”),“URL”必须填写为
http://你的NAS或服务器IP:7814,特别注意,URL末尾不能带有斜杠“/”。
-
测试元数据匹配 在您的媒体库中任意选择一本有声书,点击其“重新匹配元数据”选项。

在弹出的提供商选择列表中,选择您刚刚添加的“喜马拉雅”。随后,工具会为您列出多个可能匹配的结果以供选择。

成功匹配后,书籍的封面、作者、朗读者、简介等元数据信息都会被自动填充,非常完整。

-
设为默认提供商(可选) 测试确认无误后,您可以返回媒体库的设置界面,选择“编辑”媒体库。

Docker一键部署网页版模拟城市CubeCity:完整搭建与畅玩教程
CubeCity游戏简介:
这是一款专注于城市建设的模拟经营类游戏。玩家将从一片空白土地开始,通过逐步建造住宅区、商业中心、工业设施以及环境景观等多种建筑类型,合理设计道路网络,有效管理金币收入和人口增长,从而亲手打造出你心目中的完美城市。

主要特色功能:
- • 🏙️ 自由建设: 你可以随意放置、移动或拆除各种建筑与道路,自由创作独具个性的城市风貌。
- • 🧩 策略规划: 需要巧妙平衡住宅区 (R)、商业区 (C) 和工业区 (I) 的发展比例,同时兼顾环境 (E)、社会 (S) 和治理 (G) 等多方面需求,以实现城市的长期繁荣与可持续发展。
- • 💰 经济系统: 游戏中的建筑会自动产生金币收益,玩家可以利用这些金币来建造新的建筑、升级现有设施或拓展城市版图。
- • 💾 本地存储: 所有城市进度数据都会自动保存在本地浏览器中,方便你随时中断或继续建设任务。
- • 🎨 卡通风味: 游戏采用明快鲜艳的色彩搭配和可爱生动的卡通模型,为玩家营造出轻松愉快的视觉感受。
游戏玩法详解:
- • 🔍 选择模式 (SELECT):
- • 点击任意建筑即可查看详细信息,例如居民数量、当前状态、资源产出等数据。
- • 当建筑满足特定条件时,你可以对其进行升级操作,从而增强其功能并提高产出效率。
- • 🏗️ 建造模式 (BUILD):
- • 从游戏界面左侧的面板中选择你想要建造的建筑类型。
- • 在地图上可用的空地位置点击鼠标,即可成功放置建筑;系统会提供实时模型预览和高亮提示,使得操作过程更加直观便捷。
- • 🚚 搬迁模式 (RELOCATE):
- • 首先选中一个已经建造完成的建筑,然后点击地图上另一块空地,便能轻松实现建筑搬迁。
- • 在最终放置前,你还可以旋转建筑模型,以便更好地适应城市的整体布局规划。
- • 💣 拆除模式 (DEMOLISH):
- • 切换到拆除模式后,直接点击那些不再需要的建筑即可将其移除。
- • 拆除建筑时会返还部分建造成本,减少玩家的资源损失。
在线演示地址:
Docker部署步骤
通过Docker Compose快速部署:
Docker快速部署VoceChat:打造私有聊天应用的完整图文指南
VoceChat是一款支持独立部署的个人云社交媒体聊天服务,它能够灵活适用于多种场景,包括团队内部协作沟通、私人聊天应用、网站客服系统以及网站内嵌社区的实现。
该应用体积轻巧,仅约15MB,可以轻松部署在绝大多数服务器环境中。同时,它提供了跨多个平台的客户端支持,确保了用户在不同设备上都能获得一致的体验。

如果您希望先直观了解其功能界面,可以访问官方提供的在线演示站点进行体验。

在线演示地址:https://privoce.voce.chat/
部署步骤
推荐使用Docker Compose来快速部署VoceChat服务器,以下是一个标准化的配置示例。您只需将这段代码保存为docker-compose.yml文件,然后在同一目录下执行启动命令即可。
services:
vocechat-server:
image: privoce/vocechat-server:latest
container_name: vocechat-server
ports:
- 3000:3000
volumes:
- ./data:/home/vocechat-server/data
restart: always
配置与使用指南
部署完成后,在浏览器的地址栏中输入http://您的服务器IP地址:3000,即可访问VoceChat的初始化引导界面。

首次打开时,系统会提供清晰的操作提示,只需按照屏幕上的步骤逐步进行配置。

首先,您需要为您的聊天服务器设置一个易于辨识的名称。

接下来,创建管理员账户,设置安全的登录密码以确保管理权限的安全。

在注册设置环节,保持默认选项通常是最便捷的选择,这表示允许开放注册。

初始化完成后,系统会生成一个邀请链接。您可以复制此链接并分享给其他用户,邀请他们加入并注册成为新成员。

所有设置步骤完成后,您将正式进入VoceChat的主界面。

应用的整体界面设计得相当简洁明了,主要功能区域一目了然,降低了用户的学习成本。

为了测试聊天功能,您可以创建第二个测试账号。通过两个账号之间的对话,可以完整地体验消息发送、接收等核心交互流程。

在管理面板中,管理员可以对所有成员进行有效管理,例如分配角色或调整权限。

对于聊天过程中产生的重要文件或关键对话记录,用户可以使用收藏功能将其标记保存,便于日后快速查找。

所有在聊天中上传过的文件都会被系统集中管理,用户可以在专属的文件库中浏览和下载这些历史资料。

设置菜单中包含了许多可自定义的选项,虽然内容较为丰富,但每一项的设置逻辑都较为直接,普通用户也能轻松上手配置。

评价与总结
作为一款轻量级的聊天应用程序,VoceChat在功能广度上自然无法与大型商业社交平台相提并论。它的定位更倾向于满足那些对功能需求相对基础,但同时高度重视部署便捷性、数据隐私安全以及轻量化运行的特定场景。
如果您正在寻找一个能够“开箱即用、保障通信私密性、且资源占用极低”的聊天解决方案,那么VoceChat无疑是一个值得考虑的备选方案。
综合推荐指数:⭐⭐⭐(优势在于轻量化与快速部署) 实际使用体验:⭐⭐⭐(界面直观,跨平台支持良好) 部署复杂度评估:⭐⭐(过程非常简单)
Qwen3-0.6b Docker浏览器部署全攻略:本地运行大语言模型完整指南
Qwen-Web 是一款设计用于在本地浏览器环境中直接运行 Qwen3-0.6b 大型语言模型的开源项目,其核心优势在于实现零安装流程、不进行任何日志记录,并且完全保障用户数据的本地私密性。
您可以通过在线演示地址提前体验该项目的基本功能与交互界面。
在线演示地址

部署与安装步骤
本项目推荐使用 Docker Compose 进行快速部署,以下为完整的服务配置代码块。
services:
qwen-web:
image: heizicao/qwen-web:latest
container_name: qwen-web
ports:
- 8443:443
restart: always
操作使用指南
完成容器部署后,在浏览器地址栏中输入 https://您的NAS_IP地址:8443 即可访问应用主界面,请务必注意该服务强制使用 HTTPS 安全协议进行连接。

温馨提示:若浏览器提示“您的连接不是私密连接”,属于自签名证书的正常现象,请手动选择“继续前往”或类似选项即可正常访问。

每次通过网页首次访问时,系统都需要从本地加载 Qwen3-0.6b 的模型文件到内存中,此过程可能需要短暂等待。

界面顶部的导航栏提供了颜色主题切换功能,用户可以根据个人偏好选择浅色或深色显示模式。

应用背景支持添加网格化视觉效果,这一设计元素能够增强界面的科技感与层次感。

在输入框键入问题并按下回车键后,模型将开始生成思考过程并输出回答内容。

界面会实时显示模型的回复速度,例如示例中的 14.93 TPS(每秒生成标记数)。由于答案生成过程伴有完整的“思考链”展示,实际交互体验中的响应速度感知尚在可接受范围内。

左侧边栏预设了多个对话角色模板,用户可以直接选择特定角色以开启具有不同风格和背景的聊天会话。

整个网页聊天过程中的模型推理计算,均通过 WebGPU 技术调用您设备本地的 GPU 硬件资源来完成,无需依赖远程服务器。

项目总结与综合评估
该项目在概念和实践层面都颇具新意,成功实现了在标准浏览器环境中本地化运行 Qwen3 系列大型语言模型。其技术核心在于利用现代 WebGPU 接口,使得网页应用能够直接调度终端设备的 GPU 进行高性能计算与图形渲染。不过,当前版本仍存在一些可优化的空间,例如对个人电脑界面的适配尚不完善,且模型在运行过程中偶现响应停滞或意外输出英文回复的缺陷。尽管如此,从技术探索和娱乐体验的角度出发,它依然是一个富有乐趣的工具,既能满足运行前沿语言模型的好奇心,也可作为测试本地 GPU 计算性能的一个轻量级基准场景。
综合推荐指数:⭐⭐⭐(创意新颖,值得尝试)
实际使用体验:⭐⭐(界面相对简单,偶发性问题影响流畅度)
部署流程难度:⭐(配置极其简单,近乎一键完成)
TrWebOCR免费中文离线OCR工具:高效识别与简易部署全攻略
TrWebOCR 是一款开源且易于使用的中文离线OCR项目,其识别准确率能够与大型商业解决方案相媲美。该项目提供了直观的Web操作页面以及灵活的API接口,方便用户进行文字提取和集成。

部署与安装指南
以下是使用 Docker Compose 快速部署 TrWebOCR 的配置文件示例,只需简单几步即可完成环境搭建。
services:
trwebocr:
image: mmmz/trwebocr:latest
container_name: trwebocr
ports:
- 8089:8089
restart: always
操作步骤与使用演示
完成部署后,在浏览器地址栏中输入 http://NAS的IP:8089 即可访问 TrWebOCR 的Web操作界面。

在Web界面中上传或选择需要识别的图片文件,随后点击识别按钮即可启动OCR处理流程。

识别过程通常非常迅速,例如本次演示在不到两秒的时间内就完成了处理,界面上会清晰地用选框标出识别出的文字区域。

在大多数情况下,文字识别结果都相当准确(需要注意的是,当字体间距过于紧密或使用特殊字体时,识别精度可能会受到一定影响)。

在进行OCR识别任务时,该工具会占用较高的CPU计算资源,相比之下其对内存的消耗则保持在较低水平。

综合评价与总结
TrWebOCR 作为一款轻量级、开源且支持完全离线运行的中文OCR工具,其部署过程极为简便。该工具识别速度出色,在图片质量清晰且字体常规的条件下,能够保持较高的识别准确率。尽管其用户操作界面设计较为简洁,但功能完备且实用,同时提供了API接口供程序化调用。对于具有本地OCR需求,希望处理日常文档、屏幕截图等文字提取任务的用户,都可以尝试部署并使用这款工具。
综合推荐指数:⭐⭐⭐(即开即用,提供API接口)
实际使用体验:⭐⭐⭐(识别速度快,操作直观)
部署难度评级:⭐(非常简单)
从零开始搭建传奇三私服:Zircon Mir3 Server 完整部署图文教程
Zircon Mir3 Server 是一个基于皓石传奇三的开源服务器端项目。该项目起源于吉米在2019年发布的Zircon版本,经过后续发展,致力于提供一个能够跨平台运行并支持Docker容器化部署的传奇三游戏服务器环境。需要特别强调的是,该项目仅供技术研究与学习使用,任何商业用途或非法行为均被严格禁止。

该项目实现了相当完整的游戏内容体系:
- 游戏中包含了战士、法师、道士以及刺客四大经典职业。
- 每个职业平均设计了多达38个不同的技能供玩家学习与使用。
- 拥有丰富多样的地图场景和道具系统,支持玩家角色等级提升至100级。
- 技能系统支持修炼至第6级,装备系统则包含了精炼等深度玩法。
- 法师与道士职业所召唤的宠物,具备成长系统,最高可升级至暗金等级。
在部署支持方面,该服务器端展现出良好的灵活性:
- 支持在Linux、Windows以及Docker容器等多种平台环境中进行部署。
- 项目提供了便于使用的Docker Compose配置文件示例,简化了容器化部署流程。
此外,服务器还集成了一些便捷的游戏内功能:
- 游戏内的传送石道具,允许玩家方便地传送到任意已开放的地图。
- 支持游戏客户端进行自动更新(此功能需要v1.0.0及以上版本的客户端配合)。
准备工作提示:为了便于用户快速部署,相关的资源文件已打包整理。你也可以按照后续的详细步骤自行操作,或通过加入开发者社群获取必要的文件。

第一步:获取与准备资源文件
首先,访问该开源项目的代码仓库地址:https://gitee.com/raphaelcheung/zircon-legend-server

在项目页面向下浏览,可以找到通过百度网盘下载资源的链接(同样,也可以通过加入社群获取这些文件)。

请将列出的三个文件全部下载下来,后续的每个步骤都需要用到它们。

接下来,解压名为“服务器运行”的压缩包文件。请注意,由于文件编码或格式问题,建议在Windows系统上进行解压操作,在NAS或Mac系统上解压时即使输入正确密码也可能报错。解压密码为:“QQ群 915941142”。

在你的NAS设备或服务器上,创建一个名为zircon的文件夹,将上一步解压得到的所有文件放入此文件夹内。

第二步:部署游戏服务端
使用Docker Compose是部署服务端最便捷的方式。你可以创建一个docker-compose.yml文件,并写入以下配置内容:
services:
zircon:
image: raphzhang/zirconlegend:latest
container_name: zircon
ports:
- 7000:7000
volumes:
- ./datas:/zircon/datas
- /etc/localtime:/etc/localtime:ro
- /etc/timezone:/etc/timezone:ro
restart: unless-stopped
关键参数说明(更多高级配置建议参考项目官方文档):
/zircon/datas:此卷映射路径用于持久化存放服务器的各类配置和游戏数据。/etc/localtime与/etc/timezone:这两个可选卷映射用于同步容器与宿主机的时区设置,确保游戏内时间显示准确。
启动容器后,通过查看容器日志来验证服务是否运行正常。当在日志中看到服务器成功启动并监听端口的消息时,即表示服务端部署成功。

第三步:配置与运行游戏客户端
首先,解压之前下载的“客户端运行文件”压缩包,其中包含了游戏运行所必需的海量地图、角色模型、音效等资源文件。

仅靠资源文件还无法启动游戏,你还需要下载客户端的主程序。请访问客户端项目地址:https://gitee.com/raphaelcheung/zircon-legend-client

在项目页面右侧,找到并点击“发行版”或“Releases”标签页,跳转到版本发布页面。

在发布页面中,找到最新的客户端主程序压缩包并点击下载。

将下载的客户端主程序解压,你应该能看到类似Legend.exe等文件。使用文本编辑器打开其中的Legend.ini配置文件。

在配置文件中,找到服务器地址(IP)和端口号(Port)的设置项,将其修改为你实际部署的服务端的IP地址和端口(默认为7000),其余配置可暂时保持默认。
