feat: add more

This commit is contained in:
Sun-ZhenXing
2025-10-06 21:48:39 +08:00
parent f330e00fa0
commit 3c609b5989
120 changed files with 7698 additions and 59 deletions

88
src/kodbox/README.zh.md Normal file
View File

@@ -0,0 +1,88 @@
# Kodbox
[English](./README.md) | [中文](./README.zh.md)
此服务部署 Kodbox,一个功能强大的 Web 文件管理器和云存储平台,具有类似 Windows 的用户体验。
## 服务
- `kodbox`: Kodbox 主应用服务器。
- `kodbox-db`: Kodbox 的 MySQL 数据库。
- `kodbox-redis`: 用于缓存和会话管理的 Redis。
## 环境变量
| 变量名 | 描述 | 默认值 |
| ------------------- | ------------------------------ | ------------------ |
| KODBOX_VERSION | Kodbox 镜像版本 | `1.62` |
| KODBOX_PORT | Kodbox Web 界面的主机端口映射 | `80` |
| MYSQL_VERSION | MySQL 镜像版本 | `9.4.0` |
| MYSQL_HOST | MySQL 主机 | `kodbox-db` |
| MYSQL_PORT | MySQL 端口 | `3306` |
| MYSQL_DATABASE | MySQL 数据库名 | `kodbox` |
| MYSQL_USER | MySQL 用户名 | `kodbox` |
| MYSQL_PASSWORD | MySQL 密码 | `kodbox123` |
| MYSQL_ROOT_PASSWORD | MySQL root 密码 | `root123` |
| REDIS_VERSION | Redis 镜像版本 | `8.2.1-alpine3.22` |
| REDIS_HOST | Redis 主机 | `kodbox-redis` |
| REDIS_PORT | Redis 端口 | `6379` |
| REDIS_PASSWORD | Redis 密码(留空表示不需要认证) | `""` |
请创建 `.env` 文件并根据需要进行修改。
## 数据卷
- `kodbox_data`: 用于存储 Kodbox 应用和用户文件的卷。
- `kodbox_db_data`: 用于存储 MySQL 数据的卷。
- `kodbox_redis_data`: 用于存储 Redis 数据的卷。
## 快速开始
1. (可选)创建 `.env` 文件以自定义设置:
```env
KODBOX_PORT=8080
MYSQL_PASSWORD=your-secure-password
MYSQL_ROOT_PASSWORD=your-secure-root-password
```
2. 启动服务:
```bash
docker compose up -d
```
3. 访问 `http://localhost`(或您配置的端口)
4. 首次访问时按照安装向导操作
## 初始设置
首次访问时,安装向导将引导您完成:
- 数据库配置(从环境变量自动填充)
- 创建管理员账户
- 基本设置配置
**注意**: 如果您在 `.env` 中更改了数据库凭据,请确保在安装向导中也进行相应更新。
## 功能特性
- **类 Windows 界面**: 在 Web 浏览器中提供熟悉的桌面体验
- **多云支持**: 连接本地磁盘、FTP、WebDAV 和各种云存储服务
- **文件管理**: 支持拖放的全功能文件操作
- **在线预览**: 预览 100+ 种文件格式,包括 Office、PDF、图片、视频
- **在线编辑**: 内置文本编辑器,支持 120+ 种语言的语法高亮
- **团队协作**: 细粒度权限控制和文件共享
- **插件系统**: 通过插件扩展功能
## 文档
更多信息请访问 [Kodbox 官方文档](https://doc.kodcloud.com/)。
## 安全提示
- 在生产环境中更改所有默认密码
- 在生产环境中使用 HTTPS
- 定期备份所有数据卷
- 保持 Kodbox、MySQL 和 Redis 更新到最新稳定版本
- 在生产环境中考虑为 Redis 设置密码