flrnnc/seafile-client

Seafile Client Docker镜像

镜像概述和主要用途

该Docker镜像旨在将一个或多个Seafile库同步到本地卷，并可作为数据卷共享给其他容器使用。它提供了灵活的配置选项，适用于需要在容器环境中集成Seafile文件同步功能的场景。

支持的标签

镜像版本与Seafile版本对应：

• 9, 9.0, 9.0.13, latest
• 8, 8.0, 8.0.10
• 7, 7.0, 7.0.10

核心功能和特性

• 同步一个或多个Seafile库
• 支持密码保护的库
• 支持双因素认证
• 可配置上传和下载速度限制
• 可跳过SSL证书验证
• 可设置文件所有权（用户/组ID）
• 每周构建镜像以保持安全更新

使用场景和适用范围

• 作为容器化应用的数据存储后端，提供Seafile库的持久化同步
• 在多容器环境中共享Seafile库数据
• 需要安全、可控地同步Seafile文件的场景

使用方法和配置说明

启动Seafile客户端

Docker命令行

以下命令启动单个Seafile库的同步：

bash
docker run \ 
    -e SEAF_SERVER_URL="https://seafile.example/" \
    -e SEAF_USERNAME="a_seafile_user" \
    -e SEAF_PASSWORD="SoMePaSSWoRD" \
    -e SEAF_LIBRARY="an-hexadecimal-library-uuid" \
    -v path/to/library:/library \
    -v path/to/client/data:/seafile \
    flrnnc/seafile-client:latest

Docker Compose

以下Docker Compose配置启动两个Seafile库的同步，其中一个受密码保护：

yaml
version: "3"

services:
  seafile-client:
    image: flrnnc/seafile-client:latest
    volumes:
      - audio:/library/audio
      - documents:/library/documents
      - client:/seafile
    environment:
      SEAF_SERVER_URL: "https://seafile.example/"
      SEAF_USERNAME: "a_seafile_user"
      SEAF_PASSWORD: "SoMePaSSWoRD"
      SEAF_LIBRARY_AUDIO: "audio-library-uuid"
      SEAF_LIBRARY_AUDIO_PASSWORD: "auDioLiBRaRyPaSSWoRD"
      SEAF_LIBRARY_DOCUMENTS: "documents-library-uuid"

volumes:
  audio:
  documents:
  client:

库配置

通过环境变量配置库同步，支持单库或多库模式：

单库同步

使用SEAF_LIBRARY（库UUID）和SEAF_LIBRARY_PASSWORD（可选，库密码）环境变量，库将同步到/library目录。

多库同步

对每个库使用带标识符的环境变量：SEAF_LIBRARY_[IDENTIFIER]（库UUID）和SEAF_LIBRARY_[IDENTIFIER]_PASSWORD（可选，库密码）。标识符为单个单词，库将同步到/library/[IDENTIFIER]目录。

环境变量

SEAF_SERVER_URL

必选变量

Seafile服务器URL。

SEAF_USERNAME

必选变量

Seafile账户用户名。

SEAF_PASSWORD

必选（与SEAF_TOKEN二选一）

Seafile账户密码。

SEAF_TOKEN

必选（与SEAF_PASSWORD二选一）

Seafile账户API令牌。若同时提供SEAF_PASSWORD和SEAF_TOKEN，API令牌优先。

SEAF_LIBRARY, SEAF_LIBRARY_[IDENTIFIER]

必选变量

要同步的库UUID。多库时，[IDENTIFIER]为每个库的唯一单字标识符。

SEAF_LIBRARY_PASSWORD, SEAF_LIBRARY_[IDENTIFIER]_PASSWORD

库密码（可选）。多库时，[IDENTIFIER]需与SEAF_LIBRARY_[IDENTIFIER]对应。

SEAF_2FA_SECRET

双因素认证密钥。需在Seafile Web界面2FA设置时获取（QR码中或cookie中）。

SEAF_UPLOAD_LIMIT, SEAF_DOWNLOAD_LIMIT

上传/下载速度限制（字节为单位）。

SEAF_SKIP_SSL_CERT

跳过SSL证书验证。任意字符串均视为启用，省略该变量则禁用。适用于SSL证书相关同步失败的情况。

UID, GID

覆盖运行Seafile客户端的用户/组ID，从而设置卷文件所有权。

Docker Secrets

所有环境变量均支持Docker Secrets，通过添加_FILE后缀的环境变量引用密钥文件。

完整配置示例

yaml
version: "3"

services:
  seafile-client:
    image: flrnnc/seafile-client:latest
    volumes:
      - audio:/library/audio
      - documents:/library/documents
      - client:/seafile
    environment:
      SEAF_SERVER_URL: "https://seafile.example/"
      SEAF_USERNAME: "a_seafile_user"
      SEAF_PASSWORD: "SoMePaSSWoRD"
      SEAF_LIBRARY_AUDIO: "audio-library-uuid"
      SEAF_LIBRARY_AUDIO_PASSWORD: "auDioLiBRaRyPaSSWoRD"
      SEAF_LIBRARY_DOCUMENTS: "documents-library-uuid"
      SEAF_2FA_SECRET: "JBSWY3DPEHPK3PXPIXDAUMXEDOXIUCDXWC32CS"
      SEAF_UPLOAD_LIMIT: "1000000"
      SEAF_DOWNLOAD_LIMIT: "1000000"
      SEAF_SKIP_SSL_CERT: "true"
      UID: "1000"
      GID: "1000"

volumes:
  audio:
  documents:
  client:

故障排除

• 在Seafile论坛提问
• 在Gitlab贡献代码或报告问题