﻿蜂维云联 · 服务端（Windows 版）
=============================================================

【这是什么】
Windows 上直接双击就能跑的中心服务端。单 exe，免装 Python，
免装运行库，拷过去就能用。

功能和其他两个版本完全一样：发授权、管账号、管设备、下发组网参数，
自己也是内网节点（默认虚拟 IP 10.7.0.1）。

适合装在：Windows Server、Windows 10/11 办公电脑、小型服务器。


【目录结构】
  蜂维云联-服务端-Windows\
    蜂维云联-服务端.exe              主程序（8.7 MB，单文件）
    1-启动服务端.bat                 前台启动，会弹个黑窗口
    2-后台运行-无窗口.vbs            后台启动，不弹窗
    3-安装开机自启.bat               注册计划任务，开机自启
    4-卸载开机自启.bat               取消开机自启
    5-停止服务端.bat                 停掉正在跑的服端
    使用说明.txt                     更细的操作说明
    web\                            控制台网页文件
      index.html  app.js  style.css  licenses.html
    et\bin\                         组网内核
      easytier-core.exe   2.6.4     组网主程序
      wintun.dll                    虚拟网卡驱动
      Packet.dll                    抓包驱动
      WinDivert64.sys               流量重定向驱动
      （Windows 版不需要 easytier-cli，内核状态走本地 HTTP 接口读取）
    data\                           运行数据（首次启动自动生成）
      fwlink.db   数据库
      token.key   令牌密钥
      logs\       日志


【校验值】
  蜂维云联-服务端.exe
    大小：9,136,411 字节
    SHA256：53D96CDBB75ADB1FA7F208BBCC13AA99E15AD764589DA00EA8491C4C331CF159

  校验方法（PowerShell）：
    Get-FileHash "蜂维云联-服务端.exe" -Algorithm SHA256


【安装步骤】
  1. 把整个 蜂维云联-服务端-Windows 文件夹拷到目标机器，
     比如 D:\蜂维云联-服务端-Windows\
     （注意：整个文件夹都要拷，web\ 和 et\bin\ 缺一不可）

  2. 双击 1-启动服务端.bat
     看到类似这样的输出就成功了：
       [蜂维云联] 服务端已启动
       控制台: http://127.0.0.1:8787

  3. 浏览器打开 http://本机IP:8787
     首次进入会要求初始化管理员账号。

  4. 进"授权"页填授权码激活。

  5. 想让它在后台常驻、开机自动起：
     先关掉刚才的黑窗口，再双击 2-后台运行-无窗口.vbs

  6. 想开机自启：
     双击 3-安装开机自启.bat（会注册一个叫 FeeweiVlanServer 的计划任务）
     取消自启就双击 4-卸载开机自启.bat


【注意：Windows 防火墙】
  第一次启动时 Windows 会弹窗问"是否允许此应用访问网络"，
  一定要点"允许"，并且勾上"专用网络"。
  如果没弹或者点了取消，手动加一条规则：

    控制面板 → Windows Defender 防火墙 → 高级设置 → 入站规则 → 新建规则
    端口 → TCP → 特定本地端口 8787 → 允许连接

  或者用管理员 PowerShell 执行：
    netsh advfirewall firewall add rule name="FeeweiVlan8787" dir=in action=allow protocol=TCP localport=8787


【服务管理】
  启动：1-启动服务端.bat  或  2-后台运行-无窗口.vbs
  停止：5-停止服务端.bat
  看端口有没有在听：
    netstat -ano | findstr :8787

  注意：单文件 exe 运行时会有两个进程（父进程 + 真正的服务进程），
  这是正常的打包方式导致的，不影响使用。


【健康检查】
  浏览器打开：
    http://127.0.0.1:8787/api/health
  正常返回：
    {"ok":true,"version":"1.3.6","brand":"蜂维云联","needs_setup":false,
     "uptime":...,"et_ready":true,"license_mode":"full"}


【端口说明】
  8787    控制台 + 接口
  11010   组网监听（tcp/udp）
  15888   内核本地管理端口（只听 127.0.0.1）


【这条路已经实测过的（验收记录）】
  在本机 Windows 上完整跑通过：
    · 源码模式启动，8799 端口 /api/health 200，et_ready=true
    · POST /api/setup 初始化成功
    · /api/overview 显示中心节点 running、6 个 peers
    · POST /api/accounts 建账号成功
    · POST /api/client/login 返回 200，
      虚拟 IP 10.7.0.10、6 个 peers、607 字节 toml，
      bundle.args 逐项核对正确
    · exe 模式 /api/health 200，网页 200
    · VBS 后台启动后端口在监听、health 200
  所以三个服务端里，Windows 版是实测轮次最多的。


【常见问题】

  Q: 双击 bat 一闪就没了？
  A: 说明启动失败。在文件夹里按住 Shift + 右键 → "在此处打开
     PowerShell 窗口"，然后执行：
       .\蜂维云联-服务端.exe --port 8787
     这样报错信息会留在窗口里，能看清是什么问题。

  Q: 提示端口被占用？
  A: 换个端口。用记事本打开 1-启动服务端.bat，
     把 8787 改成 8788 保存，再双击。

  Q: 网页打得开，但 et_ready 是 false？
  A: 组网内核没起来。检查：
     1) et\bin\ 下 4 个文件是不是都在
     2) 有没有被杀毒软件把 easytier-core.exe 隔离了
     3) 端口 11010 有没有被别的程序占
     看 data\logs\ 下的日志，里面有具体原因。

  Q: 装在服务器上，客户端连不上？
  A: 服务器防火墙要放行 8787。云服务器还要在安全组放行。

  Q: 换机器要迁移？
  A: 把整个文件夹拷过去。data\fwlink.db 里是账号、设备、授权，
     一起带走就等于整机迁移。换机器后授权可能因为指纹变化
     需要重新激活，找厂商处理。


【第三方开源组件】
  EasyTier 2.6.4（LGPL-3.0），独立进程调用，不改源码。
  控制台"关于"页有完整声明。
  需要源码邮件 5990217@qq.com。


【三个服务端怎么选】
  飞牛 NAS 上装        → 1-服务端-飞牛NAS
  普通 Linux 服务器    → 2-服务端-Linux通用
  Windows 机器         → 3-服务端-Windows（就是本目录）

  三者功能一致，选一个装即可。不要在同一台机器上装两个。
=============================================================
