AutoGLM WebUI 部署指南
🚀 快速启动（参考 appinstalltest）
独立模式（推荐，无需 Docker）
cd web_ui
./start_standalone.sh
Docker 模式
cd web_ui
# 构建镜像
docker build -t autoglm .
# 启动服务
docker run -d -p 8792:8792 --name autoglm autoglm
访问
浏览器访问：http://localhost:8792
📦 架构说明
┌─────────────────────────────┐ ┌─────────────────────────────┐
│ Linux 服务器 │ │ Mac 本地 │
│ (Docker 部署) │ HTTP │ (pip 安装) │
│ │◀────────▶│ │
│ 服务端 (remote_server) │ 注册 │ 本地端 (local_server) │
│ 端口: 8792 │ 心跳 │ 端口: 8793 │
│ │ │ │
│ - 页面展示 │ │ - 设备管理 │
│ - 配置管理 │ │ - 截图/远程控制 │
│ - 接收本地端注册 │ │ - AI 任务执行 │
│ - 代理转发 │ │ - 主动注册到服务端 │
└─────────────────────────────┘ └─────────────────────────────┘
▲ │
│ ▼
│ ┌──────────────┐
访问 Web │ Android/iOS │
│ 设备 │
└──────────────┘
工作流程：
- Linux 服务端启动（Docker）
- Mac 本地端启动，指定服务端地址，自动注册
- 用户访问服务端 Web 页面
- 服务端代理请求到已注册的本地端
🐳 服务端部署 (Linux Docker)
🇨🇳 中国大陆用户（推荐）
1. 自动配置 Docker 国内源
cd web_ui
./setup_docker_china.sh
这个脚本会：
- 配置 Docker 国内镜像加速源
- 启用 BuildKit 加速构建
- 优化 DNS 设置
2. 一键构建和启动
# 使用中国大陆优化构建脚本
./build_china.sh
3. 启动服务
# 不需要指定任何 Mac 地址！
docker-compose up -d
4. 管理服务
# 停止服务
./stop.sh
# 查看状态
docker-compose ps
# 查看日志
docker-compose logs -f
# 重启服务
docker-compose restart
# 完全清理（删除容器、镜像、数据）
./clean.sh
🌍 国际用户 / 手动配置
1. 构建镜像
cd web_ui
docker build -t autoglm-server .
2. 运行容器
docker run -d \
-p 8792:8792 \
--restart always \
--name autoglm-server \
autoglm-server
或使用 docker-compose：
docker-compose up -d
🔧 独立模式部署（最简单）
适合单机使用，参考 appinstalltest 的架构。
快速启动
cd web_ui
./start_standalone.sh
这个脚本会：
- 检查 Python 环境
- 安装依赖包
- 检查设备连接
- 启动 Web 服务
手动启动
cd web_ui
pip install -r requirements.txt
python server.py
访问
浏览器访问：http://localhost:8792
🖥️ 分离模式部署（多设备场景）
方式一：pip 安装（推荐）
# 打包
cd web_ui
python setup.py sdist bdist_wheel
# 安装
pip install dist/autoglm_local-1.0.0-py3-none-any.whl
方式二：直接运行
pip install -r requirements_local.txt
python start_local.py --server http://服务器IP:8792
启动本地端
# 指定服务端地址，自动注册
autoglm-local --server http://服务器IP:8792
# 或使用环境变量
export SERVER_URL=http://服务器IP:8792
autoglm-local
启动后，本地端会：
- 自动向服务端注册
- 定期发送心跳（30秒）
- 报告连接的设备列表
📋 部署示例
🇨🇳 中国大陆完整部署流程
假设：
- Linux 服务器 IP:
192.168.1.200 - Mac 本地 IP:
192.168.1.100
Step 1: Linux 服务器配置和部署
# 进入项目目录
cd /path/to/cloudGLM/Open-AutoGLM/web_ui
# 🚀 中国大陆用户：配置 Docker 国内源
./setup_docker_china.sh
# 🏗️ 使用优化构建脚本
./build_china.sh
# 🚀 启动服务
docker-compose up -d
# 检查状态
docker-compose ps
docker-compose logs -f
Step 2: Mac 本地端部署
# 在 Mac 上进入项目目录
cd /Users/chenwenkun/Documents/AIcwk/cloudGLM/Open-AutoGLM/web_ui
# 📦 打包安装本地端
python setup.py sdist bdist_wheel
pip install dist/autoglm_local-1.0.0-py3-none-any.whl
# 🚀 启动本地端，指定服务端地址
autoglm-local --server http://192.168.1.200:8792
Step 3: 验证部署
# 🌐 浏览器访问
http://192.168.1.200:8792
# 📱 页面会自动显示已注册的本地端和连接的设备！
🔧 快速启动脚本（中国大陆）
创建 start_china.sh：
#!/bin/bash
# 中国大陆一键启动脚本
echo "🇨🇳 AutoGLM 中国大陆启动脚本"
# 配置 Docker（如果还没配置）
if [ ! -f ~/.docker/daemon.json ]; then
echo "🔧 配置 Docker 国内源..."
./setup_docker_china.sh
fi
# 构建和启动
echo "🏗️ 构建服务端..."
./build_china.sh
echo "🚀 启动服务..."
docker-compose up -d
echo "✅ 部署完成！"
echo "🌐 访问地址: http://localhost:8792"
echo "📝 本地端启动命令: autoglm-local --server http://服务器IP:8792"
🔧 配置说明
本地端参数
| 参数 | 说明 | 默认值 |
|---|---|---|
--server, -s |
服务端地址 | 无（独立运行） |
--port, -p |
本地端口 | 8793 |
--name, -n |
本地端名称 | 主机名 |
环境变量
| 变量名 | 说明 |
|---|---|
SERVER_URL |
服务端地址 |
LOCAL_PORT |
本地端口 |
LOCAL_NAME |
本地端名称 |
🛠️ API 说明
服务端新增 API
| 路径 | 方法 | 说明 |
|---|---|---|
/local/register |
POST | 本地端注册 |
/local/heartbeat |
POST | 本地端心跳 |
/local/list |
GET | 列出所有本地端 |
/local/{name} |
DELETE | 移除本地端 |
⚠️ 注意事项
- 网络连通性：Mac 需要能访问 Linux 服务器的 8792 端口
- 防火墙设置：
- Linux: 允许 8792 端口入站
- Mac: 允许 8793 端口入站（服务端代理请求）
- 心跳超时：本地端 60 秒无心跳会被标记为离线
- 多本地端：支持多台 Mac 同时注册到同一服务端
作者
chenwenkun
Release files for autoglm-local 1.6.45
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| autoglm_local-1.6.45.tar.gz | 88.9 MB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| autoglm_local-1.6.45-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 181.3 MB
Release files / autoglm_local-1.6.45.tar.gz
| Download URL | autoglm_local-1.6.45.tar.gz |
|---|---|
| Size | 88.9 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
a782601f0e816b6d4e23dfcaf9680661a9b57859e4ff737130a5a355916f0f30
|
|
BLAKE2b-256 checksum How to use checksums |
6fa6e0301c88ce4c4bea82689561ec64023cfb7976b3e2900acf92864fae4142
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.9
|
Release files / autoglm_local-1.6.45-py3-none-any.whl
| Download URL | autoglm_local-1.6.45-py3-none-any.whl |
|---|---|
| Size | 92.3 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f864edab7fbe6f426cb4d146e8086967295d4bfc7419d2680031ff6714205e44
|
|
BLAKE2b-256 checksum How to use checksums |
c59134ab97ab8856a09bec5376faf2756eebef7e73061e781cf01b3d58a4bf60
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.9
|
Security for autoglm-local 1.6.45
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
