📖 使用文档

从安装到运维，完整了解简云的所有功能与配置方法。

📥 安装指南

系统要求

• Android 7.0（API 24）或更高版本
• 建议 RAM 4GB 以上，以获得最佳运行体验
• 建议剩余存储空间 2GB 以上（用于存放组件和网站文件）

下载安装

1. 从 官方网站 下载最新版 APK
2. 允许「安装未知来源应用」（系统设置或安装时授权）
3. 打开简云 App

⚙️ 首次设置

首次打开简云，需要完成以下权限授权：

授权完成后，你就可以开始使用简云了。建议先去「组件」页面下载所需的服务组件。

📦 下载组件

简云的核心服务组件需要单独下载。进入「组件」页面，选择需要的组件点击下载：

🌐 网站管理

组件下载完成后，就可以添加网站了。

添加站点

1. 进入「设置」→「网站管理」
2. 点击「添加站点」，输入网站名称（如 myblog）
3. 输入端口号（如 8080，建议使用 1024 以上端口）
4. 系统会自动检测端口是否被占用
5. 添加成功后，Nginx 会自动重载配置

访问站点

在浏览器中输入 http://手机IP:端口 即可访问。例如：

http://192.168.1.100:8080

手机 IP 可以在简云仪表盘顶部查看（内网 IP）。

删除站点

在网站管理列表中，点击站点旁的删除按钮即可移除。删除后 Nginx 会自动重载。

🚀 启动服务

在仪表盘页面，你可以独立控制每个组件的启停：

• 点击组件旁的开关按钮即可启动/停止对应服务
• 开关旁边的状态指示灯会实时反馈运行状态（绿色 = 运行中，灰色 = 已停止）
• 支持「自动启动」配置：开启后，每次打开 App 会自动启动该组件

启动 Nginx 和 PHP 后，之前添加的网站就可以正常访问了。

📡 FTP 服务

简云内置了基于 Apache FtpServer 的 FTP 服务，方便你远程管理网站文件。

配置 FTP 用户

1. 进入「设置」→「FTP 服务」
2. 点击「添加用户」，设置用户名和密码
3. 选择用户的主目录（即网站文件所在目录）
4. 保存配置

启动 FTP

• 在仪表盘或 FTP 设置页开启 FTP 开关
• 可切换访问模式：公网访问（允许外网连接）或 仅本机（仅限本地访问）
• 运行日志可在 FTP 设置页查看

连接信息：

服务器：你的手机 IP
端口：21（默认）
用户名：你设置的用户名
密码：你设置的密码

🔗 WebSocket 服务

简云的 WebSocket 服务端支持实时双向通信，适用于聊天、推送、协作等场景。

启动 WebSocket

• 在仪表盘打开 WebSocket 开关
• 默认端口可在设置中调整

安全特性

• Token 认证 — 客户端连接需要携带有效 Token
• IP 封禁 — 可手动封禁/解封恶意 IP
• 连接限速 — 防止单个连接占用过多带宽
• 连接数限制 — 控制最大并发连接数

客户端管理

在 WebSocket 管理页面，你可以查看当前在线的客户端列表、发送消息、断开连接等。

🗄️ phpMyAdmin

phpMyAdmin 是一个基于 Web 的 MariaDB 数据库管理工具，让你在浏览器中管理数据库。

启动

1. 确保 MariaDB 组件已下载并启动
2. 在仪表盘点击「phpMyAdmin」按钮，或在浏览器中访问对应地址

功能

• SQL 查询 — 执行自定义 SQL 语句
• 表结构管理 — 创建、修改、删除数据表
• 数据导入/导出 — 支持 CSV、SQL 等多种格式
• 用户管理 — 创建和管理数据库用户

🌐 网络配置

内网访问

确保手机和电脑连接在同一个 Wi-Fi 网络下，然后使用仪表盘上显示的内网 IP 地址访问。

公网访问

如果需要从外网访问，有以下方案：

• 内网穿透 — 使用内网穿透工具（简云内集成）
• 端口转发 — 在路由器中设置端口转发到手机内网 IP
• 注意：公网访问需要考虑安全性和运营商限制

🎨 主题切换

简云内置了 10 套精美主题配色：

• 石板灰 (Slate) / 蓝 (Blue) / 绿 (Green) / 紫 (Purple)
• 橙 (Orange) / 红 (Red) / 青 (Cyan) / 粉 (Pink)
• 靛蓝 (Indigo) / 棕 (Brown)

在「设置」→「主题」中选择你喜欢的配色，界面会实时切换。主题会应用到状态栏、按钮、进度环等全局 UI 组件。

🔄 应用更新

简云支持应用内更新：

1. 进入「设置」→「关于」→「检查更新」
2. 如果有新版本，会显示更新日志
3. 点击「下载」按钮，下载完成后自动安装

你也可以在 官方网站 下载最新 APK 手动安装。

❓ 常见问题

需要 ROOT 吗？

不需要。简云在 Android 应用沙箱内运行所有服务，无需 ROOT 权限。

端口被占用怎么办？

添加网站时如果提示端口冲突，换一个端口即可。建议使用 8080、8081 等 1024 以上的端口。

手机重启后服务会丢失吗？

配置和网站文件不会丢失，但服务需要重新启动。你可以在设置中开启「自动启动」功能。

数据会泄露吗？

简云仅访问 App 指定目录的文件，不上传不收集任何个人信息。所有服务在本地运行，数据完全由你掌控。

支持 HTTP/2 或 HTTPS 吗？

当前版本的 Nginx 支持 HTTP/2。HTTPS 需要自行配置证书，后续版本会提供更便捷的配置方式。

为什么组件下载失败？

请检查网络连接是否正常。如果使用移动数据，建议切换到 Wi-Fi 网络。组件下载支持断点续传，下载中断后重新下载会从断点继续。

🔧 故障排除

服务启动失败

• 确认组件已下载完成（在「组件」页面查看下载状态）
• 检查端口是否被其他应用占用
• 重启 App 后重试

网站无法访问

• 确认 Nginx 和 PHP 都已启动（仪表盘状态灯为绿色）
• 确认输入的端口号与添加网站时设置的端口一致
• 确认手机和访问设备在同一网络（内网访问）
• 尝试在手机浏览器中访问 http://127.0.0.1:端口 测试

数据库连接失败

• 确认 MariaDB 已启动
• 默认用户名：root，密码为空
• 如果修改过密码，请使用修改后的密码连接

FTP 无法连接

• 确认 FTP 服务已启动
• 检查用户名和密码是否正确
• 如果使用公网访问模式，确认网络运营商没有屏蔽 21 端口