开源社区
项目信息
Z1 是一个开源项目，基于 GNU AGPLv3 协议发布。
贡献方式
提交 Issue
发现 Bug 或有功能建议？欢迎提交 Issue：
- 先搜索是否已有类似 Issue
- 描述清楚：环境、复现步骤、期望行为、实际行为
- 附上日志/截图更佳
提交 PR
bash
# 1. Fork 仓库
# 2. 克隆你的 Fork
git clone https://gitee.com/你的用户名/nas.git
# 3. 创建分支
git checkout -b feat/your-feature
# 4. 提交修改
git add -A
git commit -m "feat: 你的功能描述"
# 5. 推送并发起 PR
git push origin feat/your-feature贡献方向
| 方向 | 需求 |
|---|---|
| 🔧 功能开发 | 参考 TODO.md 中的待办项 |
| 🐛 Bug 修复 | 查看 Issues 列表 |
| 📖 文档完善 | 产品手册/部署指南/FAQ |
| 🎨 UI/UX | Design System v2.0 组件优化 |
| 🌐 国际化 | i18n 多语言支持 |
| 🧪 测试 | 单元测试/集成测试/硬件兼容性测试 |
技术栈
| 组件 | 技术 | 版本 |
|---|---|---|
| 后端 | Go | 1.25 |
| 前端 | Alpine.js | 3.x |
| 操作系统 | Debian | 13 (trixie) |
| 文件共享 | Samba | 4.x |
| RAID | mdadm | 最新 |
| 逻辑卷 | LVM2 | 最新 |
| 防火墙 | UFW + Fail2ban | 最新 |
| 远端同步 | rclone | 1.74+ |
| 文件管理 | FileBrowser | 最新 |
| 构建 | VitePress | 1.6+ (官网) |
社区资源
- Architecture v1.0 — 架构宪法，二十条建议评审结论
- 产品手册 — 完整部署/使用文档
- CHANGELOG — 版本变更日志
- TODO — 优化路线图（26 项，已完成 14 项）
第三方依赖
Z1 使用以下开源组件：
| 组件 | 用途 | 协议 |
|---|---|---|
| Samba | SMB 文件共享 | GPL |
| NFS | Linux 文件共享 | GPL |
| vsftpd | FTP 服务 | GPL |
| rclone | 远端同步/S3/WebDAV | MIT |
| mdadm | RAID 管理 | GPL |
| LVM2 | 逻辑卷管理 | GPL |
| UFW | 防火墙 | GPL |
| Fail2ban | 入侵防护 | GPL |
| FileBrowser | Web 文件管理 | MIT |
| Alpine.js | 前端框架 | MIT |
完整许可证见 THIRD_PARTY_LICENSES.md