各框架的官方网站
前期准备工作
Linux/Ubuntu设备、闲置QQ号
Linux环境检查
检查与安装Git
# 检查 Git 版本git --version
# 如果显示 "command not found"，请执行安装命令：sudo apt update && sudo apt install git -y检查与安装Docker(可选)
# 检查 Docker 版本docker --version如果没有安装Docker，需要进行安装
# 更新索引并安装Ubuntu自带的docker包sudo apt updatesudo apt install docker.io docker-compose-v2 -y检查环境与Github.com的网络连通性
ping github.com如果 ping通了,延迟在100-300ms左右均属正常，可以继续。 如果显示Time out或Name or service not known：说明你的服务器无法解析或连接到 GitHub，直接clone源码大概率会失败
鸣潮机器人框架主体部署
GsCore早柚核心框架部署
一键部署并启动容器
docker run -d \ --name gsuid_core \ --restart always \ -p 8765:8765 \ -v /opt/gscore_data:/gsuid_core/data \ -v /opt/gscore_plugins:/gsuid_core/gsuid_core/plugins \ -v gsuid_core_venv:/venv \ docker.cnb.cool/gscore-mirror/gsuid_core:latest如果你需要自定义 docker run 命令，可以参考下表修改对应参数：
| 参数 | 功能说明 | 备注 |
|---|---|---|
-d | 后台运行 | 容器将在后台持续执行，不会占用当前终端窗口。 |
--name gsuid_core | 容器命名 | 为容器指定一个名字，方便后续执行 docker stop 或 logs 命令。 |
-p 8765:8765 | 端口映射 | 宿主机端口:容器端口。映射后通过 IP:8765 访问后台。 |
-v /opt/gscore_data:/gsuid_core/data | 数据持久化 | 极其重要！存放玩家账号和数据库，防止容器删除后数据丢失。 |
-v /opt/gscore_plugins:/gsuid_core/.../plugins | 插件挂载 | 允许你在宿主机直接增删插件文件，无需进入容器内部。 |
-v gsuid_core_venv:/venv | 环境持久化 | 使用命名卷存储 Python 虚拟环境，加快二次启动速度。 |
--add-host host.docker.internal:host-gateway | 映射宿主机 IP | 允许容器内部通过 host.docker.internal 访问宿主机上的服务。 |
-e http_proxy=... | 网络代理 | 如果服务器在国内，设置此项可加速插件下载（需配合代理软件）。 |
-e UV_INDEX=... | Python 镜像源 | 可设置为阿里云或清华源，加速依赖包安装。 |
克隆源码并进入目录
git clone https://cnb.cool/gscore-mirror/gsuid_core.gitcd gsuid_core启动构建
# 复制环境配置（可选）cp .env.example .env# 后台构建并启动docker compose up -d --build检查uv安装情况
uv -V如果没有显示版本号，则需要下载
# 使用官方脚本一键安装curl -LsSf https://astral.sh/uv/install.sh | sh
# 立即生效环境变量 (针对当前会话)source $HOME/.cargo/env
# 验证安装是否成功uv -V克隆源码并进入目录
git clone https://cnb.cool/gscore-mirror/gsuid_core.gitcd gsuid_core安装依赖
# uv安装依赖方式uv python install 3.13uv sync --python 3.13uv run python -m ensurepip启动
# 当前目录下uv run core安装XutheringWavesUID与配套的签到插件RoverSign
进入GsCore项目的根目录，进入gsuid_core文件夹，进入plugins文件夹
git clone https://github.com/Loping151/XutheringWavesUID.git
git clone https://github.com/Loping151/RoverSign.git重启GsCore
配置网页控制台
开放端口号
GsCore默认运行在8765端口号，故而需要服务器配置中开放8765端口号
访问地址为：http://your-ip:8765/app
获取注册码
进入到早柚核心根目录，进入data文件夹，打开config.json文件，文件顶部在masters字段下填写你的QQ号，这是作为主人QQ
滑动到文件底部，可以看到REGISTER_CODE，复制它的值，这就是注册码，是注册网页控制台账户的唯一凭证
注册并进入网页控制台
这里可以解决99%的配置问题
在网页控制台Core核心配置中填写WebSocket Token，这是为安全性考虑
上游机器人框架部署
部署NapCat与AstrBot
mkdir astrbotcd astrbotwget https://raw.githubusercontent.com/NapNeko/NapCat-Docker/main/compose/astrbot.ymlsudo docker compose -f astrbot.yml up -d配置AstrBot连接GsCore
- 准备好在GsCore控制台填写的WebSocket Token
- 进入AstrBot控制台，点击
插件市场，搜索关键词gscore，点击安装，等待安装完成 如果没有安装成功则使用镜像地址 - 进入
AstrBot插件菜单，搜索关键词gscore，点击插件配置，填入连接Core的WsToken
验证连接情况与主人设置
在QQ中对机器人发送corestatus，如果成功返回图片，则代表当前用户为主人用户，且QQ已经正确连接到AstrBot
发送ww帮助,如果有帮助图片返回则证明插件运行成功，到此只剩下最后一步
向作者申请伤害计算token以及接入全排行token
总排行申请、反馈（仅限主人）：群号 387393347（需中转一次，因为被炸过群了）。如完全不使用QQ平台，可发邮件给客服小维 agent@loping151.com（记得写标题）申请计算服务token，要求附带具体使用平台、core信息截图和使用情况和规模说明，支持较少的请求量和用户量，但完全足以小范围使用，一般都欢迎入群。
-
为什么需要申请总排行进行使用：
为了确保不被上传大量伪造数据影响持有率、排行等，以及 https://ngabbs.com/read.php?tid=45654606
-
总排行申请有无条件？
待在群里，潜水不沙
-
除了总排行，插件本体功能是否有其他内容需要申请：
无。评分功能由于是独立的服务，与插件本体无关。
控制台填写token完成后，发送ww下载全部资源
参考以及致谢
分享文章
生成精美分享图或复制链接，与更多人分享本文。
继续阅读
部署教程
连载中最后更新于 ，距今已过 179 天
部分内容可能已过时
评论