部署教程

从一台电脑或服务器开始，完成 萌卡 NT 2.1.0 的安装、管理员绑定和账号配置。Windows 与 Linux 只需选择对应的一条安装路线，之后使用同一套网页控制台。

本文配图全部来自测试服务器上的真实框架，统一使用 PC 浏览器、1600 × 1000、浅色主题。点击图片可查看原图。截图中的 17887 是隔离测试端口；新部署默认使用 7878，请以自己的实际端口为准。

1. 准备安装包

打开 2.1.0 正式下载页，在 Assets 中选择一个安装包，同时下载 SHA256SUMS.txt。

不需要额外安装数据库、Redis 或 Docker。 框架使用本地 SQLite 与进程内缓存；“容器”里的组件按需要安装。请准备可以登录 萌卡 NT 官网 的账号，并确保部署机器能访问官网身份服务。

2. 安装并启动框架

Windows：解压后运行

将 Windows ZIP 和 SHA256SUMS.txt 放在同一目录，在此目录打开 PowerShell，先校验安装包：

$package = '.\mengka-nt-2.1.0-windows-amd64.zip'
$actual = (Get-FileHash -LiteralPath $package -Algorithm SHA256).Hash
$line = Get-Content -LiteralPath '.\SHA256SUMS.txt' |
    Where-Object { $_ -match '  mengka-nt-2\.1\.0-windows-amd64\.zip$' }
if (@($line).Count -ne 1 -or $actual -ne ($line -split '\s+')[0]) {
    throw '校验失败，请重新下载安装包和 SHA256SUMS.txt'
}
Write-Host '校验通过，可以解压'

看到“校验通过”后，解压到新的固定目录并运行。下面使用 C:\Mengka-NT；目录已存在时请改用新目录，避免覆盖已有实例。

if (Test-Path -LiteralPath 'C:\Mengka-NT') {
    throw '目录已存在，请选择新的安装目录'
}
Expand-Archive -LiteralPath '.\mengka-nt-2.1.0-windows-amd64.zip' -DestinationPath 'C:\Mengka-NT'
Set-Location 'C:\Mengka-NT'
.\mengka-nt.exe

成功标志： 程序保持运行，浏览器能打开 http://127.0.0.1:7878。不要在压缩包内运行，也不要只复制 EXE；public 和随包 data 必须一起保留。关闭运行窗口会停止框架。

Linux：安装到固定目录

以下用于首次安装，需要 sudo 权限、curl、tar 和 sha256sum。命令自动识别架构、校验安装包，创建运行用户 mengka，安装到 /opt/mengka-nt。该目录已存在时会停止，不覆盖数据。

set -eu
case "$(uname -m)" in
  x86_64) arch=amd64 ;;
  aarch64|arm64) arch=arm64 ;;
  *) echo '没有适用于此 CPU 架构的安装包'; exit 1 ;;
esac
if sudo test -e /opt/mengka-nt; then
  echo '/opt/mengka-nt 已存在，请勿把首次安装命令用于升级'
  exit 1
fi

stage=$(mktemp -d)
cd "$stage"
asset="mengka-nt-2.1.0-linux-${arch}.tar.gz"
release='https://github.com/Carlor-Official/Mengka-NT/releases/download/v2.1.0'
curl -fL --retry 3 -o "$asset" "$release/$asset"
curl -fL --retry 3 -o SHA256SUMS.txt "$release/SHA256SUMS.txt"
grep "  ${asset}$" SHA256SUMS.txt > selected.sha256
sha256sum -c selected.sha256

if ! id mengka >/dev/null 2>&1; then
  sudo useradd --system --no-create-home --shell /usr/sbin/nologin mengka
fi
sudo install -d -o mengka -g mengka /opt/mengka-nt
sudo tar -xzf "$asset" -C /opt/mengka-nt
sudo chown -R mengka:mengka /opt/mengka-nt
sudo chmod +x /opt/mengka-nt/mengka-nt
cd /opt/mengka-nt
sudo -u mengka ./mengka-nt

成功标志： 校验输出 OK，程序持续运行；在自己的 PC 浏览器打开 http://服务器IP:7878，出现初始化页面。先保持终端开启，初始化后按第 7 节配置后台运行。

应该打开哪个地址

HTTP 和 IP 都可以访问，不要求先准备域名或证书。浏览器中的 127.0.0.1 指当前电脑，不是远程服务器。

3. 初始化并登录控制台

阅读协议

首次访问进入“初始化萌卡NT”。依次阅读“用户协议”和“隐私说明”，两份文件均到达文末后勾选同意，再点击“同意并继续”。

绑定官网管理员

点击“前往官网生成”，登录官网后进入个人中心 → 个人令牌。创建并复制个人令牌，回到框架填写：

点击“完成初始化”，按页面提示进入控制台。这里绑定的是框架管理员，不是 QQ 机器人账号；不需要填 QQ 密码，也不会创建额外的本地管理员密码。个人令牌不要发给其他人，也不要填到插件 WS 令牌字段。

登录并检查概览

登录页选择“官网账号密码”或“个人令牌”，使用刚绑定的身份登录。图形验证码按当前页面填写，失效时点击图片刷新。

进入“概览”后，应能看到服务器资源和左侧管理菜单。新实例的在线账号和消息数量为 0 是正常现象。刷新页面后仍能进入，即可继续配置账号。

4. 配置节点、指纹和 QQ 账号

按顺序操作：节点决定从哪里连接，指纹提供设备信息，账号选择前两项完成登录配置。

添加直连节点

1. 点击左侧“节点”，再点右上角“添加节点”。
2. 名称填“本机直连”。不使用代理时，保持“开启代理”关闭。
3. 点击“添加”，确认列表显示“已启用”。已有可用节点时可以复用。

代理端口、框架网页端口和插件 WS 端口用途不同，不要混填。

一键生成指纹

1. 点击左侧“指纹 → 一键生成”。
2. 第一次可将数量设为 1，名称填写便于识别的前缀。
3. 点击“生成 1 个指纹”，确认列表出现新设备。

长期运行的账号应保持设备配置稳定。多个账号分别准备指纹，不要因为一次离线就反复删除账号、更换设备。

添加 QQ 账号

进入“账号 → 添加账号”。填写自己的 QQ 号，按所选协议填写登录资料，再选择刚准备的指纹和节点。

添加后回到列表点击“登录”，按提示完成验证。状态变为在线才代表 QQ 登录完成；出现账号记录不代表已经登录。

Linux 登录方式

Linux 账号点击“登录”后先选择方式：

• 免扫登录：同一个 QQ 号已有在线 Android 会话时可选，由该会话授权 Linux 登录。
• 扫码登录：没有可用的同 QQ Android 会话时使用，按页面二维码和确认提示操作。

免扫按钮不可点击时，检查同 QQ Android 账号是否在线。其他 QQ 号不能代替授权。已有缓存的账号按框架恢复提示处理，不必删除重建。

5. 配置并安装插件

先设置插件访问入口

打开“插件 → 插件市场”。市场显示官网审核上架的插件，自动识别的是框架服务器的系统与架构，不是当前浏览器所在的电脑。

点击卡片“配置”或上方“访问设置”：

1. 选择 HTTP 或 HTTPS。
2. 填浏览器可以访问的服务器 IP 或域名。远程部署不要照抄 127.0.0.1。
3. 点击“一键配置”。框架检查并分配空闲端口，为待配置插件生成入口。
4. 按结果放行必要的访问端口，再回卡片点击“下载”。

HTTP 会明文传输管理会话和数据，公网管理建议用 HTTPS。一键配置检查本机端口冲突，不会替你修改云安全组。新增插件后可再次配置补齐新入口，已有配置不会重新覆盖。

下载后到哪里管理

点击“下载”后，框架在服务器下载、解压并启动插件，同时生成 WS 连接配置。切到市场内 “已安装” 分组管理：

修改插件数据目录前先停止并备份。自定义存储目录和允许访问目录的操作见一体化插件部署说明。

独立 WS 插件如何接入

在“插件 → 插件对接”添加服务：正向 WS 由框架监听、插件连接；反向 WS 由插件监听、框架连接。两端填写相同令牌，并核对实际地址和端口。

6. 等级任务与会员签到（可选）

从账号打开“等级加速”，选择相应 Android 账号，勾选任务、设置时间并保存计划。框架统一调度，关闭浏览器不影响已保存的计划。

“电脑QQ在线”可使用同 QQ Android 会话授权 Linux 免扫登录，时长和任务进度以 QQ 返回为准。“会员签到”有独立开关，成长值不计入 QQ 加速天数；开启前阅读每项说明，部分任务会发布说说。

这不是框架部署的必做项，完整规则见等级任务与会员签到。

7. Linux 设置后台运行

初始化完成后，回到启动终端按 Ctrl+C 停止前台进程。前面已安装到 /opt/mengka-nt 并创建 mengka 用户，这里复用同一目录和身份。

sudo tee /etc/systemd/system/mengka-nt.service >/dev/null <<'EOF'
[Unit]
Description=Mengka NT
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
User=mengka
Group=mengka
WorkingDirectory=/opt/mengka-nt
ExecStart=/opt/mengka-nt/mengka-nt
Restart=on-failure
RestartSec=5
KillMode=mixed
TimeoutStopSec=45

[Install]
WantedBy=multi-user.target
EOF
sudo systemctl daemon-reload
sudo systemctl enable --now mengka-nt.service
sudo systemctl status mengka-nt.service --no-pager

成功标志： 状态为 active (running)，断开 SSH 后 PC 浏览器仍能访问。自定义数据和插件目录也需要给运行用户相应权限。

常用命令：

# 查看最近日志
sudo journalctl -u mengka-nt.service -n 80 --no-pager
# 重启 / 停止
sudo systemctl restart mengka-nt.service
sudo systemctl stop mengka-nt.service

8. 更新、备份与恢复

更新前备份完整框架目录，以及所有自定义插件数据目录；它们可能不在框架 data 内。

Windows：先关闭框架进程，再运行：

$backup = 'C:\Mengka-NT-backup-' + (Get-Date -Format 'yyyyMMdd-HHmmss')
Copy-Item -LiteralPath 'C:\Mengka-NT' -Destination $backup -Recurse
Write-Host "备份完成：$backup"

Linux：停止后备份整个安装目录：

sudo systemctl stop mengka-nt.service
backup="/opt/mengka-nt-backup-$(date +%Y%m%d-%H%M%S).tar.gz"
sudo tar -czf "$backup" -C /opt mengka-nt
echo "备份完成：$backup"

备份后如需在线更新，Windows 重新启动框架，Linux 执行 sudo systemctl start mengka-nt.service。有新版本时使用控制台顶部“在线更新”，按版本说明操作。手动更新需校验新包，替换程序与网页，并按该版本说明更新随包配置；不要用空白 data 覆盖数据库、管理员绑定、账号缓存和插件配置。

更新后检查版本、账号恢复、节点和插件状态。需要回滚时先停止新进程，恢复同一份备份中的程序、网页和数据，避免旧程序配上已迁移的新数据。

9. 验收与常见问题

基础部署完成后检查：PC 登录和刷新正常；所需节点可用、账号能登录；如需插件，其访问设置和连接状态正常；Linux 断开 SSH 后仍能访问，并已保留备份。

官网 API 文档 · 公开插件 SDK 与 Demo · 插件发布说明