seppi91/seafile

Seafile 镜像（支持指定 UID/GID）

镜像概述

本镜像为 foxel/seafile 的分支版本，主要用于部署 Seafile 文件同步与共享系统。在保留 Seafile 核心功能的基础上，新增了通过环境变量指定运行服务的用户ID(uid)和组ID(gid)的功能，解决了容器内文件权限与宿主机不一致的问题，提升了部署灵活性和安全性。

核心功能与特性

基础功能

• 完整继承 Seafile 核心功能，包括文件同步、文件共享、版本控制、在线文件编辑、团队协作等
• 支持 Web 界面管理，提供直观的文件操作与权限控制
• 兼容 Seafile 官方的数据结构与配置方式

增强特性

• 自定义 UID/GID：通过环境变量指定运行 Seafile 服务的用户ID和组ID，避免容器内文件权限与宿主机冲突
• 权限隔离：确保容器内进程以非 root 用户运行，符合安全最佳实践
• 数据持久化：支持挂载宿主机目录存储 Seafile 数据，确保数据持久化与备份

使用场景

• 企业内部文件共享与协作平台搭建
• 团队项目文档管理与版本控制
• 需要精确控制文件权限的多用户环境
• 对容器安全性有较高要求的部署场景（如避免 root 用户运行服务）

使用方法

基本运行命令

通过 docker run 命令快速启动容器：

bash
docker run -d \
  --name seafile \
  -p 80:80 \
  -p 443:443 \
  -v /path/to/seafile/data:/shared \
  -e SEAFILE_UID=1000 \
  -e SEAFILE_GID=1000 \
  docker.xuanyuan.run/your-image-name:latest

环境变量说明

Docker Compose 配置示例

创建 docker-compose.yml 文件：

yaml
version: '3'

services:
  seafile:
    image: docker.xuanyuan.run/your-image-name:latest
    container_name: seafile
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - /path/to/seafile/data:/shared
    environment:
      - SEAFILE_UID=1000
      - SEAFILE_GID=1000
      - SEAFILE_SERVER_HOSTNAME=seafile.example.com
      - SEAFILE_ADMIN_EMAIL=admin@example.com
      - SEAFILE_ADMIN_PASSWORD=your_secure_password
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

数据持久化

容器数据通过挂载 /shared 目录实现持久化，包含以下子目录：

• seafile-data：存储用户文件数据
• seafile-conf：Seafile 配置文件
• seafile-log：日志文件
• mysql：数据库数据（若使用内置数据库）

注意事项

1. UID/GID 匹配：确保指定的 SEAFILE_UID 和 SEAFILE_GID 在宿主机上存在，或与宿主机目录权限匹配，避免文件读写权限问题
2. 端口冲突：若宿主机 80/443 端口已被占用，可修改端口映射（如 -p 8080:80）
3. 首次启动：首次启动时会自动初始化数据库和配置文件，可能需要几分钟时间
4. HTTPS 配置：建议通过反向代理（如 Nginx）配置 HTTPS，或直接在容器内配置 SSL 证书

维护与更新

• 数据备份：定期备份 /shared 目录下的所有文件
• 镜像更新：拉取新版本镜像后，通过 docker-compose down 和 docker-compose up -d 重启服务
• 日志查看：通过 docker logs seafile 查看服务运行日志