首页/文档/服务端使用教程

服务端使用说明：登录与转绑

Windows 控制台与 Linux 宝塔两套流程，内容互相独立。先确认自己用的是哪一版，再按对应章节操作。

适用 1.0.xWindows / Linux约 8 分钟阅读

00开始之前

服务端不是「装完就能用」的离线软件，它需要一张有效的卡密（或账号）完成授权校验。登录成功后凭据会加密缓存在本地，之后重启不再需要输入。

WIN Windows 版 · 控制台程序通过启动器运行，在黑色窗口里粘贴卡密 LNX Linux 版 · 宝塔 / 守护进程没有可输入的控制台，用环境变量完成登录
转绑是什么：卡密绑定机器。换电脑、换服务器或重装系统导致机器码变化时，需要把旧设备「顶掉」，把卡换绑到新机器。两个版本都不需要你提前知道旧机器码——程序会把设备列出来。

01Windows 版

1.1 启动

Windows 版通过服务端启动器运行，不要直接双击服务端程序本身。启动器提供三种启动方式和一个停止按钮：

按钮用途
HTTP 启动纯 HTTP 方式运行（测试用，或你已自行配置了其他反向代理）
HTTPS · 证书使用证书文件直接以 HTTPS（443 端口）运行
HTTPS · 反代程序自动拉起内置反向代理，填了域名即自动 HTTPS（推荐）
停止停止服务端

点任意启动按钮后，会弹出一个黑色的服务端控制台窗口——登录、转绑等所有操作都在这个窗口里进行。不要关闭这个窗口，关闭它等于停止服务；启动器窗口只负责启动、停止和切换方式。

首次部署或卡在登录时，启动器不会误杀正在等你输入的服务端——切到那个黑色窗口完成操作即可。

1.2 登录

1

首次登录：粘贴卡密

首次启动时窗口出现登录提示，把卡密粘贴进去后按回车：

================【登陆】================
请粘贴卡密> XXXX-XXXX-XXXX   ← 粘贴卡密，回车

若服务商给你的是账号密码方式，则按窗口提示依次输入账号、密码。

2

怎么算成功了

窗口显示以下内容，随后程序继续启动并输出 HTTP 服务端口，即可正常对外提供服务：

================【登陆】================
登录成功，卡密：XXXX-XXXX-XXXX，到期时间：2027-10-12
3

之后重启不用再输入

登录成功后，凭据会加密保存在程序目录的 Main/card.dat（账号方式则是 Main/acc.dat）。以后每次启动自动登录，直接进入服务状态。

4

到期或想换一张卡

卡密到期后重启程序，会重新出现登录提示，粘贴新卡密回车即可；想在到期前主动换卡：点启动器「停止」，删除 Main\card.dat，再重新启动。

切换登录方式：之前用账号登录、现在想改用卡密（或反过来），先删掉 Main\acc.dat（账号缓存）或 Main\card.dat（卡密缓存）再启动，程序会按新方式重新询问。

1.3 转绑（换电脑 / 重装系统后）

卡密是绑定机器的。换了一台电脑，或系统重装导致机器码变化，需要把卡上绑定的旧设备「顶掉」，换绑到新机器。你不需要提前知道任何机器码——程序会把设备清单列出来，你只需输入编号。

1

在新电脑上启动，程序自动列出已绑设备

================================================================
【转绑】
本机机器码与卡密上已绑设备不匹配，需要转绑（顶掉一台旧设备）。
该卡当前绑定的设备：
[1] 办公室电脑
机器码：A1B2C3D4E5F6...
绑定时间：2026-10-01 12:00:00
本机机器码：F6E5D4C3B2A1...        ← 新电脑的机器码
输入要替换掉的设备序号；直接回车放弃本次转绑。
请选择> 1                          ← 输入要顶掉的设备编号
哪台该顶掉，看「绑定时间」一般就能判断（最旧的那台）；拿不准时联系服务商确认，避免顶掉还在用的设备。
2

程序自动完成转绑并重新登录

开始转绑：顶掉设备 A1B2C3D4E5F6...，绑定本机 F6E5D4C3B2A1...
转绑成功，正在重新登录…
================【登陆】================
登录成功，卡密：XXXX-XXXX-XXXX，到期时间：2027-10-12

转绑后无需其他操作，程序自动继续启动进入服务状态。

1.4 Windows 版常见问题

Q：粘贴卡密后提示「卡密不存在 / 已过期 / 已停用」？

  • 检查卡密是否复制完整，前后不要带空格或多余字符；
  • 过期、停用的卡无法登录，请联系服务商换卡或续期；
  • 输入错误时程序会重新出现登录提示，再粘贴一次即可。

Q：提示「程序未受保护（未加壳），无法校验授权」然后退出？

说明运行的程序文件不是官方交付的原版（被替换或改动过）。请删除当前文件，联系开发者重新获取官方程序包，不要使用来路不明的文件。

Q：不小心把还在用的另一台电脑顶掉了？

被顶掉的电脑会因授权失效而停止，属正常保护行为。在需要继续使用的那台电脑上重新走一遍转绑流程顶回来即可。

02Linux 版（宝塔 / 服务器部署）

2.1 重要背景：后台方式没有键盘

Windows 版启动后会在窗口里问「请粘贴卡密」，用键盘输入即可。Linux 版在宝塔里以守护进程方式运行，没有可以打字的控制台，所以登录和转绑都改用「环境变量」完成：

环境变量作用
NETAUTH_CARD卡密登录
NETAUTH_USER + NETAUTH_PASS账号密码登录（与卡密二选一，不混用）
NETAUTH_REPLACE_MACHINE转绑时指定要顶掉的旧设备机器码
NETAUTH_DEBUG=1排障开关：输出完整启动流水到控制台和 Main/startup.log（平时不用设）

2.2 登录

1

首次登录：设置环境变量

宝塔面板 → Go 项目管理 → 你的项目 → 项目信息 → 环境变量，从「无」改为「指定变量」，填入：

NETAUTH_CARD=你的卡密

若该应用开放的是账号方式，则填：

NETAUTH_USER=你的账号
NETAUTH_PASS=你的密码

保存后重启项目。

2

怎么算成功了

打开宝塔的「项目日志」，看到下面内容即登录成功：

凭据来源：环境变量 NETAUTH_CARD（卡密登录）
================【登陆】================
登录成功，卡密：XXXX-XXXX-XXXX，到期时间：2027-10-12
3

之后的重启不用再管

登录成功后，凭据会加密保存在程序目录的 Main/card.dat（账号则是 Main/acc.dat）。以后每次重启自动登录，不需要任何输入。

4

到期或想换一张卡

环境变量是最高优先级：改 NETAUTH_CARD 的值为新卡密 → 重启，旧缓存会自动替换，不需要手动删文件。

注意：如果从来不设环境变量、只靠缓存，卡密到期后程序会因「后台无法人工换卡」而退出。建议长期保留 NETAUTH_CARD 环境变量，换卡只改变量。

2.3 转绑（换服务器 / 重装系统后）

换了一台服务器（或系统重装导致机器码变化），需要把卡上绑定的旧设备「顶掉」。整个转绑分两步：

1

直接启动一次，去日志抄旧机器码

新机器首次启动，登录时发现机器对不上，程序会走转绑分支，项目日志里出现：

================================================================
【转绑】
本机机器码与卡密上已绑设备不匹配，需要转绑（顶掉一台旧设备）。
该卡当前绑定的设备：
[1] (未上报设备名)
机器码：A1B2C3D4E5F6...            ← 要抄的「旧机器码」
绑定时间：2026-10-01 12:00:00
本机机器码：F6E5D4C3B2A1...        ← 新服务器自己的机器码
输入要替换掉的设备序号；直接回车放弃本次转绑。
================================================================
当前没有可输入的控制台。请设置环境变量 NETAUTH_REPLACE_MACHINE 后重启。
此时程序会正常退出，属预期现象，不是故障。
2

把旧机器码填进环境变量，重启

环境变量追加一行（NETAUTH_CARD 保持不变）：

NETAUTH_REPLACE_MACHINE=A1B2C3D4E5F6...

重启项目，日志会显示自动转绑：

开始转绑：顶掉设备 A1B2C3D4E5F6...，绑定本机 F6E5D4C3B2A1...
转绑成功，正在重新登录…
================【登陆】================
登录成功，卡密：XXXX-XXXX-XXXX，到期时间：2027-10-12
3

删掉转绑变量（建议）

转绑成功后，把 NETAUTH_REPLACE_MACHINE 从环境变量里删掉再重启一次。留着一般无害，但删掉可以避免以后换卡时它指向一台早已不存在的设备。

2.4 Linux 版常见问题

Q：日志出现「程序未受保护（未加壳），无法校验授权」然后退出？

说明部署的不是官方交付的程序文件（被替换或改动过）。请删除当前文件，联系开发者重新获取官方程序包。

Q：环境变量填了还是登录失败？

  • 检查变量名拼写（全部大写、下划线分隔、等号两边不要有空格）；
  • 卡密前后不要带空格、换行；
  • 「项目日志」会写明失败原因（卡密不存在 / 已过期 / 已停用），按提示处理。

Q：服务器重装系统后又提示转绑？

重装后机器码可能变化，按 2.3 节流程再做一次转绑即可（这次日志里绑定的「旧设备」就是重装前的那台）。

Q：怀疑网络问题连不上总控？

设环境变量 NETAUTH_DEBUG=1 后重启，日志会输出完整启动流水（每一步尝试与失败原因）；程序目录 Main/startup.log 也会落一份。排障完记得把该变量去掉。

03附录一 · 运维工具与命令行

主要用于「后台进不去了」之类的自救。服务端运行中即可执行，不需要停止服务。以上工具只改登录 / 管理相关数据，不会动客户数据和业务数据（db tidy 除外）。

Windows 版：启动器里的运维工具

启动器自带运维工具下拉框和「执 行」按钮，选一项点执行即可，不用敲命令：

下拉框选项作用
查看 IP 白名单查看当前后台登录 IP 白名单（默认选中项，只读）
设置 IP 白名单填入要设置的 IP，支持单个 IP、网段（192.168.1.0/24）、范围（1.2.3.4-1.2.3.10），多个用英文逗号分隔，留空 = 不限制
清空 IP 白名单清空白名单恢复不限制。后台把白名单配错、整个后台进不去（403）时，用这个自救
查看登录锁定列表查看当前被锁定的后台账号
解锁全部登录锁定后台账号连错密码被锁、登录不进去时的解锁命令
重置超管密码忘记后台密码时找回：按提示输入两遍新密码
点「执行」后会新开一个黑色窗口显示结果，窗口停住等你按键是正常的——看完按任意键关闭。执行时窗口会先要求粘贴卡密（和启动时一样）。
进阶命令（不在下拉框里）：db tidy 按程序结构整理数据表，须按服务商指导使用（加 --prune 会删列、不可逆，执行前务必备份数据库）。方法：打开程序所在文件夹，在地址栏输入 cmd 回车，执行 NetworkAuth.exe db tidy。

Linux 版：SSH 命令行执行

cd /opt/netauth

./Server ip-whitelist                     # 查看后台登录 IP 白名单
./Server ip-whitelist --clear             # 清空（白名单配错被锁在外面时）
./Server ip-whitelist --set "1.2.3.4"     # 设置白名单（多个用英文逗号分隔）

./Server login-lock                       # 查看被锁定的后台账号
./Server login-lock --clear               # 解锁全部（账号被锁登录不进去时）

./Server reset-admin                      # 重置超级管理员密码（按提示输两遍新密码）
和启动一样，命令执行前会先要求粘贴卡密——直接在 SSH 窗口里粘贴回车即可（也可以按 2.2 节设置好环境变量，就不用每次输）。
进阶命令：./Server db tidy 按程序结构整理数据表，须按服务商指导使用（加 --prune 会删列、不可逆，执行前务必备份数据库）。

04附录二 · 两个版本差别一览

事项Windows 版Linux 版（宝塔 / 守护进程）
首次登录窗口里粘贴卡密，回车环境变量 NETAUTH_CARD
登录成功后自动缓存，重启免输相同（Main/card.dat）
换卡密到期后重启重输，或删 Main\card.dat改环境变量后重启
转绑选设备窗口里输入设备编号日志抄机器码 → NETAUTH_REPLACE_MACHINE → 重启
转绑需要知道机器码吗不需要，照编号选即可不需要，第一次启动日志里会列出来
上一站← 服务端功能与截图 下一份文档API 加密文档 →