CyberMind-FR
ccfb58124c
Add complete French (fr) and Chinese (zh) translations for all documentation: - Root files: README, CHANGELOG, SECURITY, BETA-RELEASE - docs/: All 16 core documentation files - DOCS/: All 19 deep-dive documents including embedded/ and archive/ - package/secubox/: All 123+ package READMEs - Misc: secubox-tools/, scripts/, EXAMPLES/, config-backups/, streamlit-apps/ Total: 346 translation files created Each file includes language switcher links for easy navigation between English, French, and Chinese versions. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
69 lines
2.3 KiB
Markdown
69 lines
2.3 KiB
Markdown
# SecuBox LXC 框架（预览）
|
||
|
||
> **Languages:** [English](../../DOCS/embedded/lxc-framework.md) | [Francais](../../DOCS-fr/embedded/lxc-framework.md) | 中文
|
||
|
||
**版本：** 1.0.0
|
||
**最后更新：** 2025-12-28
|
||
**状态：** 活跃
|
||
|
||
本文档记录了第 8 步中添加的基础 LXC 工具。这是未来打包为 LXC 容器的"SecuBox 应用"（例如 Lyrion）的基础，并说明了组合的 CLI/UCI 工作流程。
|
||
|
||
---
|
||
|
||
## 组件
|
||
|
||
1. **UCI 配置：** `/etc/config/lxcapps`（每个容器一个部分）。
|
||
2. **存储根目录：** `/srv/lxc/<name>/`（rootfs、config、logs）。
|
||
3. **模板：** `/usr/share/secubox/lxc/templates/`（脚本/tarball；默认为 `debian`）。
|
||
4. **CLI 助手：** `secubox-tools/lxc/secubox-lxc`（安装到 `/usr/sbin/secubox-lxc`）。
|
||
|
||
`secubox-lxc` 需要标准的 OpenWrt LXC 软件包，并使用与 BusyBox 兼容的语法。
|
||
|
||
---
|
||
|
||
## CLI 使用
|
||
|
||
```bash
|
||
secubox-lxc list # 显示已定义的容器
|
||
secubox-lxc create lyrion --bridge br-dmz --ip 192.168.50.10
|
||
secubox-lxc start lyrion
|
||
secubox-lxc stop lyrion
|
||
secubox-lxc status lyrion
|
||
secubox-lxc delete lyrion
|
||
```
|
||
|
||
每次 `create` 调用都会在 `/srv/lxc/<name>` 下创建容器目录，并在 `/etc/config/lxcapps` 中写入相应的 `config container '<name>'` 部分。这使其可被未来的 LuCI 集成发现。
|
||
|
||
---
|
||
|
||
## UCI 模式
|
||
|
||
```uci
|
||
config container 'lyrion'
|
||
option bridge 'br-dmz'
|
||
option ip '192.168.50.10'
|
||
option gateway '192.168.50.1'
|
||
option dns '1.1.1.1'
|
||
option memory '1024'
|
||
```
|
||
|
||
可以稍后添加额外选项（template、rootfs、自定义脚本）；CLI 已经支持 `--template`、`--memory`、`--bridge`、`--ip`、`--gateway` 和 `--dns` 参数。
|
||
|
||
---
|
||
|
||
## 存储和模板
|
||
|
||
- 默认 rootfs 路径：`/srv/lxc/<name>/rootfs`。
|
||
- 模板查找：CLI `--template` 参数 -> `/usr/share/secubox/lxc/templates/<name>` -> 系统 `lxc-create -t debian`。
|
||
- Bridge 默认为 `br-lan`；对于 DMZ 容器使用 `--bridge br-dmz`。
|
||
|
||
---
|
||
|
||
## 未来工作
|
||
|
||
- 通过 RPC + LuCI 暴露 `/etc/config/lxcapps`，以便清单/配置文件可以声明 LXC 应用。
|
||
- 在 App Store 中与 Docker 应用一起分发 Lyrion 和其他容器模板。
|
||
- 重用配置文件系统来自动安装 LXC 依赖项并配置容器。
|
||
|
||
目前，此工具允许高级用户在 OpenWrt ARM64 上验证 LXC，并为 App Store 提供一致的基础。
|