secubox-openwrt/docs-zh/index.md
CyberMind-FR ccfb58124c docs: Add trilingual documentation (French and Chinese translations)
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>
2026-03-20 10:00:18 +01:00

4.4 KiB
Raw Blame History

SecuBox 文档

🌐 语言: English | Français | 中文

版本: 1.0.0 最后更新: 2025-12-28 项目: OpenWrt LuCI 安全与管理套件

欢迎使用 SecuBox 文档!本综合指南涵盖了 SecuBox 模块开发、部署和维护的所有方面。


🏗️ 什么是 SecuBox

SecuBox 是一个面向 OpenWrt 的综合安全和网络管理套件,由 15 个 LuCI 应用模块组成,提供:

  • 安全监控 - CrowdSec 入侵防护、Netdata 指标
  • 网络智能 - 深度包检测、流量分类
  • 访问控制 - 强制门户、认证、VPN 管理
  • 性能优化 - QoS、带宽管理、缓存
  • 系统管理 - 集中式仪表板、服务管理

🚀 快速导航

快速入门

SecuBox 新手?从这里开始!

快速入门指南

开发指南

包含架构图的完整开发参考

开发指南

代码模板

工作示例和实现模式

代码模板

验证

模块验证和测试工作流程

验证指南


📦 15 模块套件

核心控制2 个模块)

  • SecuBox 中央控制中心 - 主仪表板和模块管理
  • 系统中心 - 系统管理(健康、服务、日志、备份等)

安全与监控2 个模块)

  • CrowdSec 仪表板 - 入侵防护和威胁情报
  • Netdata 仪表板 - 实时系统监控

网络智能2 个模块)

  • Netifyd 仪表板 - 深度包检测和分类
  • 网络模式 - 网络配置文件管理

VPN 与访问控制3 个模块)

  • WireGuard 仪表板 - VPN 隧道管理
  • 客户端守卫 - 网络访问控制和强制门户
  • 认证守卫 - 认证系统

带宽与流量2 个模块)

  • 带宽管理器 - QoS 和带宽配额
  • 流量整形器 - 高级流量整形

性能与服务2 个模块)

  • CDN 缓存 - 内容分发网络代理缓存
  • VHost 管理器 - 虚拟主机配置

系统优化2 个模块)

  • 媒体流 - 媒体流量优化
  • KSM 管理器 - 内核同页合并

查看模块状态 →


🎨 设计系统

SecuBox 使用现代、一致的设计系统:

  • 调色板: 靛蓝/紫罗兰渐变,支持深色模式
  • 字体: Inter文本+ JetBrains Mono代码/数值)
  • 组件: 卡片、徽章、按钮带渐变效果
  • 布局: 响应式网格系统

查看设计系统部分获取完整规格。


🔧 开发工作流程

!!! warning "关键规则" 1. RPCD 命名: 脚本名称必须与 ubus 对象匹配(luci.module-name 2. 菜单路径: 必须与视图文件位置完全匹配 3. 权限: RPCD 脚本 755CSS/JS 644 4. 验证: 提交前始终运行 ./secubox-tools/validate-modules.sh

开发工具

# 验证所有模块7 项自动检查)
./secubox-tools/validate-modules.sh

# 自动修复文件权限
./secubox-tools/fix-permissions.sh --local

# 本地构建包
./secubox-tools/local-build.sh build luci-app-module-name

完整开发工作流程 →


🌐 在线演示

体验 SecuBox 的实际运行:

生产演示: https://secubox.cybermood.eu

  • 主仪表板:/
  • 系统中心:/system-hub
  • CrowdSec/crowdsec
  • 所有 15 个模块均可访问

📚 文档章节

新贡献者

  1. 快速入门指南 - 基本规则和命令
  2. 开发指南 - 完整参考
  3. CLAUDE.md - 构建系统和架构
  4. 仓库指南 - 结构、工作流程和 PR 要求

AI 辅助开发

  1. 模块实现指南 - 分步工作流程
  2. 功能再生提示 - 所有模块的 AI 提示
  3. 代码模板 - 实现模式

📞 支持与资源


📝 许可证

Apache-2.0


最后更新: 2025-12-28 | 维护者: CyberMind.fr