docblue/chfs

chfs Docker镜像文档

镜像概述

chfs Docker镜像是chfs文件共享服务的官方构建版本，旨在提供简单、快速的文件共享解决方案。通过容器化部署，可便捷地搭建基于HTTP的文件共享服务，支持本地目录映射、自定义配置等功能，适用于个人或小型团队的文件交换需求。

核心功能与特性

• 目录挂载：容器内固定共享目录为/data，配置文件目录为/config，支持通过宿主机目录挂载实现数据持久化
• 配置自定义：通过/config/chfs.ini配置文件自定义共享规则、访问权限等参数
• 端口灵活映射：可根据需求将容器内80端口映射到宿主机任意端口
• 轻量级部署：镜像体积小，部署简单，无需复杂依赖

使用场景

• 本地文件临时共享服务
• 小型团队内部文件交换
• 开发环境中的文件资源共享
• 个人本地网络文件服务搭建

使用方法

基本部署命令

bash
sudo docker run \
  --name chfs \
  -d \
  -p 80:80 \
  -v local_data_path:/data \
  -v local_config_path:/config \
  docblue/chfs:v4.0beta.min

部署示例

以下命令创建一个映射宿主机8080端口、共享/mnt/chfs/data目录、使用/mnt/chfs/config目录存放配置的chfs服务：

bash
sudo docker run \
  --name chfs \
  -d \
  -p 8080:80 \
  -v /mnt/chfs/data:/data \
  -v /mnt/chfs/config:/config \
  docblue/chfs:v4.0beta.min

参数说明：

• --name chfs：指定容器名称为chfs
• -d：后台运行容器
• -p 8080:80：将宿主机8080端口映射到容器内80端口
• -v /mnt/chfs/data:/data：挂载宿主机/mnt/chfs/data目录到容器共享目录/data
• -v /mnt/chfs/config:/config：挂载宿主机/mnt/chfs/config目录到容器配置目录/config

配置说明

配置文件位置

容器内配置文件路径固定为/config/chfs.ini，需通过宿主机挂载目录进行配置。

配置文件参考

配置文件格式参考官方示例，注意：配置文件中共享目录必须设置为/data，否则会导致共享路径错误。

注意事项

• 默认文件：未挂载目录时，容器内会自动创建readme.txt文件，包含使用注意事项
• 目录权限：宿主机共享目录（如示例中的/mnt/chfs/data）的文件权限需用户自行配置管理，确保容器有权限访问
• 版本标签：镜像标签（如v4.0beta.min）表示具体版本，使用时请确认所需版本号
• 配置生效：修改配置文件后需重启容器使配置生效