WebClient工具

1. 安装部署

使用 SQLite（推荐新手）

# Windows
# 下载后直接运行
web-ssh-client.exe -port 8080 -db-type sqlite

# Linux
# 一键下载、设置权限并启动
wget -O /opt/web-ssh-client https://vnc.hlwidc.com/web-ssh-client && chmod +x /opt/web-ssh-client && /opt/web-ssh-client -port 8080 -db-type sqlite

SQLite 数据库文件会自动创建在可执行文件目录下，默认文件名为 machine_manage.db

使用 MySQL（推荐生产环境）

./web-ssh-client \
  -port 8080 \
  -db-type mysql \
  -db-host localhost \
  -db-port 3306 \
  -db-user root \
  -db-password your_password \
  -db-name machine_manage

需要先创建数据库，系统会自动创建表结构。

2. 首次登录

启动服务后，访问 http://localhost:8080
使用默认管理员账号登录：
- 用户名：admin
- 密码：admin
⚠️ 首次登录后请立即修改密码！

3. 添加机器

进入 机器管理 页面
点击 新增机器 按钮
填写机器信息：
- 厂商：选择或创建厂商
- 国家地区：选择机器所在地区
- 机器名称：自定义名称
- IP地址：必填
- 远程端口：SSH端口（默认22）
- 远程账号：SSH用户名（默认root）
- 远程密码：SSH密码
- 分组：选择或创建分组
点击确定保存

4. SSH终端连接

进入 终端管理 页面
选择要连接的机器（仅显示Linux机器）
点击连接按钮
在终端中执行命令
支持功能：
- 文件上传：点击上传按钮，选择文件
- 常用命令：快速执行预设命令
- 目录跳转：快速切换到常用目录

5. 宝塔面板管理

进入 宝塔面板管理 页面
点击 新增宝塔面板 按钮
填写面板信息：
- 面板名称：自定义名称
- 登录地址：完整的宝塔登录URL
- 登录账号：宝塔面板用户名
- 登录密码：宝塔面板密码
- BasicAuth账号（可选）：如果宝塔面板启用了BasicAuth保护，填写BasicAuth用户名
- BasicAuth密码（可选）：如果宝塔面板启用了BasicAuth保护，填写BasicAuth密码
- 端口转发（可选）：启用本地端口转发
点击 登录面板 快速访问

提示：如果您的宝塔面板配置了BasicAuth认证（HTTP基础认证），请填写BasicAuth账号和密码。系统会在访问宝塔面板时自动添加BasicAuth认证头，无需手动输入。

6. 端口转发配置

进入 端口转发 页面
点击 新增端口转发 按钮
配置转发规则：
- 目标机器：选择要转发的机器
- 源端口：本地监听端口
- 目标端口：目标机器的端口
- 状态：启用/禁用
启用后，访问 服务器IP:源端口 即可访问目标机器的目标端口

7. 用户管理（管理员）

进入 用户管理 页面
点击 新增用户 创建普通用户
分配机器给用户：
- 在机器列表中，点击分配按钮
- 选择要分配的用户
- 保存后，用户即可访问分配的机器

8. SSL/TLS 配置（HTTPS）

启用 SSL

使用 -enable-ssl 参数启用 HTTPS 支持，系统会自动生成自签名证书：

# Windows
web-ssh-client.exe --enable-ssl --server-host example.com --port 80 -db-type sqlite

# Linux
/opt/web-ssh-client --enable-ssl --server-host example.com --port 80 -db-type sqlite

功能特性：

自动生成自签名证书（有效期10年）
如果端口是80，自动改为443
证书文件保存在可执行文件目录：server.crt 和 server.key
证书基于 --server-host 参数生成，支持域名和IP地址
如果证书文件已存在，会直接使用现有证书

注意：自签名证书会在浏览器中显示安全警告，这是正常现象。可以点击"高级"继续访问，或使用正式证书（如 Let's Encrypt）替换证书文件。

9. 命令行参数说明

参数	说明	默认值
`-port`	HTTP和WebSocket服务端口	8080
`-db-type`	数据库类型：mysql 或 sqlite	sqlite
`-db-host`	数据库主机地址（MySQL）	localhost
`-db-port`	数据库端口（MySQL）	3306
`-db-user`	数据库用户名（MySQL）	root
`-db-password`	数据库密码（MySQL）	(空)
`-db-name`	数据库名称或文件路径	machine_manage.db
`-server-host`	服务器IP/域名	127.0.0.1
`-max-connections`	WebSocket最大连接数（0=不限制）	0
`-auth-key`	授权密钥	(空)
`-enable-ssl`	启用SSL/TLS（自动生成自签名证书）	false

使用教程