Android 应用使用指南

Droidspaces 的 Android 应用为管理 Linux 容器提供了精美的图形界面。它抽象化了 namespace 和挂载的复杂性，同时让你对环境拥有高层次的控制。

底部导航

• 主页：一个仪表盘，展示已安装和正在运行的容器数量、root 可用性状态以及后端版本。
• 容器：所有已安装容器的专用管理界面（安装、启动、停止、编辑和卸载）。
• 面板：一个集中式仪表盘，用于管理正在运行的容器并监控实时系统统计信息（CPU、内存、温度等）。

---

容器标签页

该标签页允许你使用"+"图标安装容器，并列出所有已安装的环境。每个容器都有一张控制卡片：

• 安装按钮（+）：安装一个新容器。
• 启动按钮：启动容器并引导 init 系统。
• 停止按钮：向容器的 init 发送优雅的关机信号。
• 循环按钮：快速重启容器。
• 终端图标（日志）：提供对容器上一次启动、停止和重启序列的持久会话日志的访问。

---

Rootfs 仓库

容器选项卡中 "+" 按钮上方的云图标可打开 Rootfs 仓库——一个内置的发行版浏览器，让你无需离开应用即可下载和安装 Linux rootfs 镜像。

使用方法

1. 点击容器选项卡中的云图标。
2. 面板打开后，会从 Droidspaces 官方仓库 加载可用发行版，仅显示与你设备架构匹配的镜像。
3. 使用搜索栏按名称、描述或作者搜索列表。
4. 在发行版卡片上点击下载。进度条会实时显示下载进度，文件保存到你的下载文件夹。
5. 下载完成后，按钮切换为安装。点击它即可直接进入容器设置向导。

添加自定义仓库

仓库支持使用相同 JSON 格式的第三方 rootfs 来源。

1. 点击面板头部的设置图标（刷新图标左侧）。
2. 输入名称和指向有效 rootfs.json 的 URL。
3. 点击添加，然后点击保存。面板将刷新并合并所有来源的结果。

---

网络配置

在编辑或创建容器时，你可以从四种网络模式中进行选择：

• 主机模式（默认）：直接共享宿主机网络。
• NAT 模式（隔离）：拥有独立的网络 namespace，支持确定性 IP 和端口转发。
• 无网络模式：无网络访问。
• 网关模式：容器的 LAN 被委托给另一个正在运行的容器（通常是 OpenWRT），由后者负责 DHCP、DNS、防火墙和路由。在 网关模式 设置中选择网关容器，并可选配置 LAN 网段、接口和网桥。完整指南请参阅从零开始的网络基础。

互联网出站接口（NAT 模式）

如果你选择 NAT 模式（隔离），互联网出站接口会完全自动检测——通常无需配置。Droidspaces 会读取内核自己的路由状态，找出 Android 当前用于访问互联网的接口（Wi-Fi、移动数据、以太网），并由后台 Route Monitor 在你切换网络时实时保持容器连接。

上游接口（可选）

如果你希望容器忽略活跃网络，并把互联网固定到指定接口，可以在上游接口中添加它们。这样会禁用自动检测，并强制 WAN 只通过你的列表：

• 列表按优先级排序并支持通配符，例如 wlan0, rmnet* 表示优先 Wi-Fi，失败时回退到移动数据（移动数据接口编号不稳定，因此建议使用 rmnet*）。
• 示例：VPN 断路保护：在手机上运行 VPN 应用，并固定 tun0，这样容器只能通过隧道访问互联网。
• 示例：手机走 Wi-Fi、容器走蜂窝网络：在开发者选项中启用“始终开启移动数据”，连接 Wi-Fi、打开移动数据，然后固定 rmnet*。

留空即可自动检测活跃上行链路（默认行为，适合大多数用户）。

端口转发

在 NAT 模式下，使用端口转发部分将宿主机端口映射到容器端口（例如 22:22）。你也可以指定端口范围（例如 1000-2000:1000-2000）来满足需要多个连续端口的服务。

---

面板标签页（活跃环境）

面板标签页专注于正在运行的容器。点击一张运行中的容器卡片即可打开详情屏幕。

容器详情屏幕

该屏幕提供了对运行环境的深入洞察：

• 容器信息：显示 Pretty Name、版本、每个容器的运行时间、主机名和 IP 地址（IPv4）。
• 可用用户：列出 rootfs 中检测到的用户。
• 复制登录命令：从下拉菜单中选择一个用户并点击此项，可复制类似 su -c 'droidspaces enter [user]' 的命令。
• 终端：原生在 Droidspaces 应用中打开一个交互式终端模拟器，进入容器内部！
• Systemd：如果容器使用 systemd，会显示一个"管理"按钮。点击它会打开所有 systemd 服务的列表，允许你直接从应用中启动、停止或重启单个服务（例如 SSH、Nginx 或 VNC 服务器）。

---

访问容器 Shell

Droidspaces 提供了两种主要方式来与运行中的 Linux 容器交互。无论是想在应用内快速查看，还是想在你最喜欢的终端中获得功能齐全的会话，我们都能满足你的需求。

方法 1：内置终端（v5.7.0+）

这是无需离开 Droidspaces 应用即可快速运行命令的最便捷方式。

1. 确保容器处于运行中状态。
2. 导航到面板标签页，点击容器以打开其详情。
3. 找到终端卡片并点击打开。
4. 选择你要登录的用户（例如 root 或你的默认用户）。
5. 一个交互式终端将直接在应用内启动。

方法 2：外部终端（复制登录）

对于喜欢使用 Termux、ADB 或其他终端模拟器的高级用户，Droidspaces 允许你将外部会话"附加"到容器。

1. 确保容器处于运行中状态。
2. 在面板标签页中打开容器详情。
3. 从下拉菜单中选择你想要的用户。
4. 点击复制登录命令。这会将类似 su -c 'droidspaces --name=[name enter [user]' 的命令复制到你的剪贴板。
5. 打开你偏好的终端（例如 Termux）并粘贴该命令。
6. 运行该命令（确保你的终端已从 root 管理器获取 root 权限）。

---

设置与要求

通过右上角的齿轮图标访问：

• 要求：对你的内核运行 27 项诊断检查。
• 内核配置：提供一份专门针对你设备的可复制 droidspaces.config 片段。
• 主题引擎：支持 AMOLED 黑、Material You、更改强调色以及浅色/深色模式。