compose-anything/src/kodbox/README.zh.md

Kodbox

English | 中文

此服务部署 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 文件以自定义设置:

   KODBOX_PORT=8080
   MYSQL_PASSWORD=your-secure-password
   MYSQL_ROOT_PASSWORD=your-secure-root-password
   

2. 启动服务:

   docker compose up -d
   

3. 访问 http://localhost(或您配置的端口)

4. 首次访问时按照安装向导操作

初始设置

首次访问时,安装向导将引导您完成:

• 数据库配置(从环境变量自动填充)
• 创建管理员账户
• 基本设置配置

注意: 如果您在 .env 中更改了数据库凭据,请确保在安装向导中也进行相应更新。

功能特性

• 类 Windows 界面: 在 Web 浏览器中提供熟悉的桌面体验
• 多云支持: 连接本地磁盘、FTP、WebDAV 和各种云存储服务
• 文件管理: 支持拖放的全功能文件操作
• 在线预览: 预览 100+ 种文件格式,包括 Office、PDF、图片、视频
• 在线编辑: 内置文本编辑器,支持 120+ 种语言的语法高亮
• 团队协作: 细粒度权限控制和文件共享
• 插件系统: 通过插件扩展功能

文档

更多信息请访问 Kodbox 官方文档。

安全提示

• 在生产环境中更改所有默认密码
• 在生产环境中使用 HTTPS
• 定期备份所有数据卷
• 保持 Kodbox、MySQL 和 Redis 更新到最新稳定版本
• 在生产环境中考虑为 Redis 设置密码