Remote Internet Access Guide Chinese
本教程详细介绍如何配置 AionUi 的公网访问，让您可以从互联网任何地方访问您的 AionUi 实例。
💡 将 AionUi 打造成您的 24/7 远程助手
通过本教程，您可以轻松配置 AionUi 的远程访问功能，实现：
- 🌐 随时随地访问：从任何有网络的地方访问您的 AionUi 实例
- 📱 便捷登录：支持扫描二维码一键登录，无需记忆复杂密码
- ⚡ 快速配置：3-5 分钟即可完成配置并开始使用
无论是出差访问家里的服务器，还是让团队成员远程协作，都能轻松实现！
- 出差时访问家里的服务器
- 让团队成员远程访问
- 从任何有网络的地方使用 AionUi
- 部署在云服务器上供多人使用
- 公司电脑访问家里服务器
- 手机用流量访问
AionUi 支持三种远程连接方式，根据您的使用场景选择：
| 连接方式 | 适用场景 | 说明 | 详细教程 |
|---|---|---|---|
| 1. 局域网连接 | 同一 WiFi/局域网内的设备访问 | 手机和电脑连同一个 WiFi，使用 --remote 参数即可 |
查看教程 → |
| 2. 远程软件（Tailscale） | 跨网络访问（如公司访问家里） | 使用 Tailscale 等 VPN 软件，无需公网 IP 和服务器 | 查看教程 → |
| 3. 服务器部署 | 24/7 运行、公网访问 | 在云服务器上部署，直接通过公网 IP 访问 | 查看教程 → |
💡 如何选择？
- 同一 WiFi 下使用 → 选择局域网连接
- 想从公司访问家里，或手机用流量访问 → 选择远程软件（Tailscale）
- 需要 24/7 运行或公网访问 → 选择服务器部署
⚠️ 注意：WebUI 目前仅支持单用户（admin）。多人可以使用同一个 admin 账号访问，但暂不支持创建多个独立用户账号。
| 方案 | 一句话说明 | 适合谁 |
|---|---|---|
| 🔐 Tailscale | 安装软件，登录账号，就能用 | 需要跨网络访问的人 |
| 🖥️ 服务器部署 | 在云服务器上部署，直接公网访问 | 有云服务器，需要 24/7 运行或公网访问的人 |
| 方案 | 难不难？ | 需要什么？ | 适用场景 |
|---|---|---|---|
| Tailscale | ⭐ 很简单 | 安装软件 | 跨网络访问，个人使用 |
| 服务器部署 | ⭐⭐ 中等 | 云服务器 | 24/7 运行，公网访问 |
- 想从公司访问家里的 AionUi
- 想用手机（用流量）访问家里的 AionUi
- 需要跨网络访问
💡 视频教程：上面的视频演示了完整的配置流程。如果视频无法播放，请参考下方的文字步骤。
在运行 AionUi 的电脑上，打开 AionUi 应用，在界面中启动 WebUI 服务：
- 打开 AionUi 应用
- 点击左侧菜单中的 "WebUI" 选项
- 在 WebUI 设置页面中：
- 打开 "启用 WebUI" 开关
- 打开 "允许局域网访问" 开关
- 启动成功后，界面会显示：
- 访问地址（如：
http://192.168.2.XXX:25808） - 登录信息（用户名和密码）
- 访问地址（如：
💡 提示：如果你更喜欢使用命令行，也可以使用
--webui --remote参数启动（详见下方"其他启动方式"）。
- 访问下载页面：https://tailscale.com/download
- 下载并安装 Tailscale 桌面版
- 打开 Tailscale 并登录你的账号（如果还没有账号，需要先注册）
登录成功后，Tailscale 会为你的设备分配一个虚拟 IP 地址（通常是 100.x.x.x 格式）。
在 Tailscale 客户端界面中，你可以看到分配给当前设备的 IP 地址：
组合访问地址：
- 复制 Tailscale IP 地址（如：
100.XX.5.123） - 在后面加上端口号
:25808 - 完整的访问地址格式：
http://100.XX.5.123:25808
⚠️ 重要：
- 你想在哪个设备上运行 AionUi，就用那个设备的 Tailscale IP 地址
- 访问地址格式：
http://Tailscale的IP地址:25808- 示例：如果 Tailscale IP 是
100.XX.5.123，那么访问地址就是http://100.XX.5.123:25808
💡 提示：你也可以在命令行运行
tailscale ip来查看 IP 地址。
在要访问 AionUi 的设备上（以手机为例），需要完成以下操作：
| 步骤 | 操作说明 |
|---|---|
| 1. 安装 Tailscale | 在手机应用商店搜索 "Tailscale" 并下载安装 或访问 https://tailscale.com/download 下载手机版 |
| 2. 登录 Tailscale | 打开 Tailscale 应用 使用与步骤 2 中相同的账号登录 确保显示为"已连接"状态 |
-
打开浏览器：打开手机浏览器（Safari、Chrome 等）
-
输入访问地址：在地址栏输入步骤 3 中组合的访问地址：
http://100.XX.5.123:25808把
100.XX.5.123替换为步骤 3 中获取的实际 Tailscale IP 地址。 -
查看登录页面：输入地址后，会显示 AionUi 的登录页面
-
登录：有两种登录方式
方式一：二维码扫描一键登录（推荐） ⭐
- 在登录页面使用手机扫描二维码，即可一键登录，无需输入密码
- 更方便快捷，推荐使用此方式
方式二：用户名密码登录
- 用户名：
admin - 密码：步骤 1 中 AionUi WebUI 设置界面显示的初始密码
-
进入聊天界面：登录成功后，会进入 AionUi 的聊天界面，现在就可以在手机上使用 AionUi 了
-
开始对话：发起会话后，就可以开始与 AionUi 对话了
💡 提示：
- 如果无法访问，检查两台设备的 Tailscale 是否都显示为"已连接"
- 确保运行 AionUi 的设备上已开启"允许局域网访问"选项
- 首次访问时，浏览器可能会提示安全警告，这是正常的，点击"继续访问"即可
如果你更喜欢使用命令行启动 WebUI，可以在运行 AionUi 的电脑上，使用以下命令：
Windows：
AionUi.exe --webui --remoteMac：
/Applications/AionUi.app/Contents/MacOS/AionUi --webui --remoteLinux：
AionUi --webui --remote启动成功后，终端会显示访问地址和初始密码。
- 查看 IP：
tailscale ip - 查看设备状态：
tailscale status
如果您有云服务器（如阿里云、腾讯云、AWS 等），可以直接在服务器上部署 AionUi，实现公网访问。
- 需要 24/7 运行
- 需要稳定的公网访问
- 有云服务器资源
- 希望从任何地方通过公网 IP 访问
⚠️ 注意：WebUI 目前仅支持单用户（admin）。多人可以使用同一个 admin 账号访问，但暂不支持创建多个独立用户账号。
- 已购买云服务器（Linux 系统，推荐 Ubuntu）
- 服务器有公网 IP
- 已安装 AionUi
sudo nano /etc/systemd/system/aionui-webui.service[Unit]
Description=AionUi WebUI Service
After=network.target
[Service]
Type=simple
User=YOUR_USERNAME
WorkingDirectory=/home/YOUR_USERNAME
ExecStart=/usr/bin/AionUi --webui --remote
Restart=on-failure
RestartSec=10
[Install]
WantedBy=multi-user.target💡 提示：将
YOUR_USERNAME和/usr/bin/AionUi替换为实际值。如果 AionUi 不在/usr/bin/，请使用完整路径。
sudo systemctl daemon-reload
sudo systemctl enable aionui-webui.service
sudo systemctl start aionui-webui.service
sudo systemctl status aionui-webui.service开放端口 25808：
# Ubuntu/Debian (ufw)
sudo ufw allow 25808/tcp
sudo ufw reload
# CentOS/RHEL (firewalld)
sudo firewall-cmd --permanent --add-port=25808/tcp
sudo firewall-cmd --reload查看服务日志获取访问地址：
sudo journalctl -u aionui-webui.service | grep "WebUI"或者直接使用服务器公网 IP 访问：http://您的服务器IP:25808
常用管理命令：
- 查看日志：
sudo journalctl -u aionui-webui.service -f - 重启服务：
sudo systemctl restart aionui-webui.service - 停止服务：
sudo systemctl stop aionui-webui.service - 查看状态：
sudo systemctl status aionui-webui.service
创建 ~/Library/LaunchAgents/com.aionui.webui.plist：
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>Label</key>
<string>com.aionui.webui</string>
<key>ProgramArguments</key>
<array>
<string>/Applications/AionUi.app/Contents/MacOS/AionUi</string>
<string>--webui</string>
<string>--remote</string>
</array>
<key>RunAtLoad</key>
<true/>
<key>KeepAlive</key>
<true/>
</dict>
</plist>launchctl load ~/Library/LaunchAgents/com.aionui.webui.plist
launchctl start com.aionui.webui在"系统设置" → "网络" → "防火墙"中开放端口 25808。
- ✅ 24/7 运行：服务器自动重启，无需手动维护
- ✅ 稳定可靠：云服务器通常有更好的网络和稳定性
- ✅ 公网访问：直接通过公网 IP 或域名访问
- ✅ 远程访问：可以从任何地方访问您的 AionUi 实例
⚠️ 注意：WebUI 目前仅支持单用户（admin）。多用户功能正在开发中。
- 使用强密码：使用复杂的管理员密码
- 防火墙配置：仅开放必要端口（25808）
- 云服务器安全组：配置安全组规则，限制访问来源 IP（如果可能）
- 定期更新：保持 AionUi 和系统更新
- 监控日志：定期检查访问日志和服务状态
- Tailscale 加密：使用 Tailscale 时自带端到端加密，无需额外配置
- 配置简单，安装软件登录即可
- 数据加密传输
- 不需要额外配置路由器或服务器
Q: 无法连接到 Tailscale 网络？
- 检查所有设备是否使用同一账号登录
- 确认 Tailscale 客户端正在运行
- 检查防火墙是否允许 Tailscale 流量
- 尝试重启 Tailscale：
sudo tailscale restart
Q: 无法访问 AionUi？
- 确认 AionUi 以
--remote模式启动 - 检查 Tailscale IP 是否正确：
tailscale ip - 确认端口 25808 未被占用
- 尝试使用设备名称而非 IP 访问
Q: 如何查看 Tailscale 连接状态？
tailscale status这会显示所有设备及其连接状态。
Q: 服务无法启动？
- 检查 AionUi 路径是否正确：
which AionUi或whereis AionUi - 检查用户权限：确保服务文件中的用户有执行权限
- 查看详细错误：
sudo journalctl -u aionui-webui.service -n 50
Q: 无法从外网访问服务器？
- 检查防火墙是否开放端口 25808
- 检查云服务器安全组规则是否允许 25808 端口
- 确认 AionUi 以
--remote模式启动 - 验证服务是否正在运行：
sudo systemctl status aionui-webui.service
Q: 如何检查端口是否开放？
# 使用 telnet 测试
telnet 您的服务器IP 25808
# 或使用 nc (netcat)
nc -zv 您的服务器IP 25808
# 检查本地端口监听
sudo netstat -tlnp | grep 25808Q: 服务自动重启失败？
- 检查日志查看具体错误：
sudo journalctl -u aionui-webui.service - 确认 AionUi 可执行文件路径正确
- 检查磁盘空间：
df -h - 检查内存使用：
free -h
- 🌐 WebUI 配置指南 - WebUI 基础配置
- 🔐 Tailscale 跨网络访问 - 使用 Tailscale 访问
- 🌍 局域网远程访问 - 同一网络内的远程访问
- 🖥️ 服务器部署 - 服务器部署指南
- Tailscale 官方文档 - Tailscale 详细文档
祝您成功配置远程外网访问！ 🚀