Skip to content

Usage-Android-App.md

Latest commit

 

History

History
139 lines (95 loc) · 7.05 KB

Usage-Android-App.md

File metadata and controls

139 lines (95 loc) · 7.05 KB
Raw

Android 应用使用指南

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

底部导航

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

容器标签页

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

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

Tip

你可以通过长按容器卡片来编辑容器配置或卸载已安装的容器。还可以迁移到基于 rootfs.img 的容器或调整现有 rootfs.img 的大小！

Rootfs 仓库

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

使用方法

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

Note

如果下载失败，卡片上会显示重试按钮。重新启动应用时，之前已下载的文件会被自动识别——安装按钮将直接可用。

添加自定义仓库

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

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

Tip

如需获得更丰富的发行版选择，可将官方 LXC 镜像源添加为自定义仓库：

  • 名称：随意填写（例如 LXC Mirror）
  • URL：https://raw.githubusercontent.com/Droidspaces/linuxcontainers-mirror/refs/heads/main/rootfs.json

网络配置

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

  • Host（默认）：直接共享宿主机网络。
  • NAT（隔离）：拥有独立的网络 namespace，支持确定性 IP 和端口转发。
  • None：无网络访问。

配置上游接口（NAT 模式）

如果你选择了 NAT（隔离）模式，你必须指定一个或多个上游接口，容器才能访问互联网。应用提供了便捷的自动检测工作流程：

  1. 检测 Wi-Fi：连接到你的 Wi-Fi 网络，然后按"上游接口"菜单中的刷新按钮。选择出现的接口（通常是 wlan0）。
  2. 检测移动数据：关闭 Wi-Fi 并连接到移动数据。再次按刷新按钮，然后选择移动数据接口（例如 rmnet0、ccmni1）。
  3. 保存：Route Monitor 将使用这两个接口，确保在切换网络时你的容器不会断开连接。

Tip

你可以在上游接口列表中手动输入通配符（例如 rmnet*），以确保即使运营商在不同的接口名称之间轮换（如 rmnet_data0 和 rmnet_data1）也能保持连接。

Note

NAT 模式仅支持 IPv4。如果你的运营商只提供 IPv6，请参阅 IPv4 NAT 解决方法。

端口转发

在 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、更改强调色以及浅色/深色模式。