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>
3.8 KiB
3.8 KiB
RezApp Forge
Docker 到 SecuBox LXC 应用转换器。
概述
RezApp Forge 将 Docker 镜像转换为 LXC 容器并生成 SecuBox 插件包。浏览 Docker Hub、GHCR 和 LinuxServer.io 目录,将镜像转换为 LXC,并发布到 SecuBox 应用商店。
功能特性
- 目录管理 - 支持 Docker Hub、LinuxServer.io、GHCR
- Docker 搜索 - 在所有启用的目录中搜索镜像
- 镜像信息 - 查看可用标签和架构
- Docker 到 LXC - 将 Docker 镜像转换为 LXC 容器
- 包生成 - 自动生成 SecuBox 插件包
- 目录发布 - 将转换的应用添加到 SecuBox 目录
安装
opkg install secubox-app-rezapp
CLI 使用方法
# 目录管理
rezappctl catalog list # 列出启用的目录
rezappctl catalog add <name> <url> # 添加自定义目录
rezappctl catalog remove <name> # 移除目录
# 搜索 Docker 镜像
rezappctl search <query> # 搜索所有目录
rezappctl search heimdall # 示例:搜索 heimdall
rezappctl info <image> # 显示镜像详情
# 将 Docker 转换为 LXC
rezappctl convert <image> [options]
--name <app-name> # 自定义应用名称
--tag <version> # 镜像标签(默认:latest)
--memory <limit> # 内存限制(默认:512M)
# 生成 SecuBox 包
rezappctl package <app-name> # 从转换的应用创建包
# 发布到目录
rezappctl publish <app-name> # 将清单添加到 SecuBox 目录
# 列出转换的应用
rezappctl list # 显示所有转换的应用
示例工作流
# 1. 搜索应用
rezappctl search heimdall
# 2. 检查可用标签
rezappctl info linuxserver/heimdall
# 3. 转换为 LXC
rezappctl convert linuxserver/heimdall --name heimdall --memory 512M
# 4. 生成 SecuBox 包
rezappctl package heimdall
# 5. 发布到目录
rezappctl publish heimdall
配置
UCI 配置:/etc/config/rezapp
config main 'main'
option cache_dir '/srv/rezapp/cache'
option output_dir '/srv/rezapp/generated'
option apps_dir '/srv/rezapp/apps'
option lxc_dir '/srv/lxc'
option default_memory '512M'
config catalog 'dockerhub'
option name 'Docker Hub'
option type 'dockerhub'
option enabled '1'
config catalog 'linuxserver'
option name 'LinuxServer.io'
option type 'dockerhub'
option namespace 'linuxserver'
option enabled '1'
转换过程
- Pull - 下载 Docker 镜像
- Export - 创建容器并导出文件系统
- Extract - 解压到 LXC rootfs
- Configure - 从 Docker 元数据生成 LXC 配置
- Wrap - 创建 LXC 执行启动脚本
生成的包结构
/srv/rezapp/generated/secubox-app-<name>/
|-- Makefile # OpenWrt 包 makefile
|-- files/
| |-- etc/config/<name> # UCI 配置
| |-- etc/init.d/<name> # Procd init 脚本
| +-- usr/sbin/<name>ctl # 管理 CLI
+-- README.md
LuCI 界面
安装 luci-app-rezapp 获取 服务 > RezApp Forge 的 Web 界面。
依赖
- docker
- lxc, lxc-common
- curl, wget-ssl
- jsonfilter
文件位置
| 路径 | 描述 |
|---|---|
/etc/config/rezapp |
UCI 配置 |
/usr/sbin/rezappctl |
CLI 工具 |
/srv/rezapp/cache/ |
下载的镜像 |
/srv/rezapp/apps/ |
转换的应用元数据 |
/srv/rezapp/generated/ |
生成的包 |
/srv/lxc/<app>/ |
LXC 容器 rootfs |
/usr/share/rezapp/templates/ |
包模板 |
模板
/usr/share/rezapp/templates/ 中的模板:
Makefile.tpl- 包 Makefileinit.d.tpl- Procd init 脚本ctl.tpl- 管理 CLIconfig.tpl- UCI 默认值start-lxc.tpl- LXC 启动包装器lxc-config.tpl- LXC 配置manifest.tpl- 应用目录清单