喵星之旅-狂奔的兔子-Seafile自建云存储部署与使用

一、Seafile 是什么

Seafile 是开源的云存储与文件同步平台,可以自建一套类似”私有网盘”的服务。跟 Nextcloud 相比,Seafile 更强调文件同步性能和协作,库(Library)是它的核心概念——每个库是一组文件,可以单独共享、设定权限。

Seafile 服务器由几个组件构成:

seafile-server —— 核心服务,负责文件存储、同步、版本管理
seahub —— Web 界面(Django 写的),负责登录、分享、权限
依赖 —— MariaDB/MySQL(元数据)、Memcached(缓存)、可选 Elasticsearch(全文搜索)

本文用 Docker 部署社区版,覆盖部署安装 + 基础配置 + 使用配置三部分。

二、Docker 部署

2.1 准备

Seafile 12.0 起使用三个配置文件:.env、seafile-server.yml、caddy.yml。先从官方拉取模板:

1
2
3
4
5
6
7
mkdir -p /opt/seafile
cd /opt/seafile

# 下载官方模板(社区版 CE)
wget -O .env https://raw.githubusercontent.com/seafile/docker/master/templates/ce.env
wget -O seafile-server.yml https://raw.githubusercontent.com/seafile/docker/master/templates/ce.seafile-server.yml
wget -O caddy.yml https://raw.githubusercontent.com/seafile/docker/master/templates/ce.caddy.yml

最低配置:2 核 CPU、2GB 内存。

2.2 修改 .env

编辑 .env,重点改这几项:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
# Seafile 数据持久化目录
SEAFILE_VOLUME=/opt/seafile-data

# 服务器域名/IP(必填,决定访问地址)
SEAFILE_SERVER_HOSTNAME=seafile.example.com

# 管理员账号(首次初始化创建)
INIT_SEAFILE_ADMIN_EMAIL=admin@example.com
INIT_SEAFILE_ADMIN_PASSWORD=你的强密码

# 时区
TIME_ZONE=Asia/Shanghai

# 数据库(内置 MariaDB 容器)
DB_HOST=db
DB_ROOT_PASSWD=数据库root密码

# HTTPS(用 Let's Encrypt 自动申请证书;没有域名先设 false)
SEAFILE_SERVER_LETSENCRYPT=false

注意:SEAFILE_SERVER_HOSTNAME 填域名时,Seafile 会用它拼出访问地址;如果只有 IP,就直接填 IP。

2.3 启动

1
2
cd /opt/seafile
docker compose up -d

首次启动会自动初始化数据库和 Seafile 配置,需要几分钟。查看进度:

1
docker compose logs -f seafile

看到类似这样就是成功了:

1
2
3
4
5
Seafile server started
Done.
Successfully created seafile admin
Seahub is started
Done.

访问 http://<服务器地址>/(或域名),用 .env 里设置的管理员账号登录。如果看到 502,说明初始化还没完成,等日志出现上面的内容再试。

三、访问方式(有域名 / 无域名 / 无公网 IP+FRP)

Seafile 的访问方式取决于你有没有域名、有没有公网 IP。.env 里的 SEAFILE_SERVER_HOSTNAME 必须和实际访问地址一致,客户端才能连上。

3.1 有域名 + 公网 IP(推荐)

  1. DNS 解析:把域名 A 记录指向服务器公网 IP
  2. .env 设置:
    1
    2
    SEAFILE_SERVER_HOSTNAME=seafile.example.com
    SEAFILE_SERVER_LETSENCRYPT=true
  3. 确保 80/443 端口开放(防火墙/安全组)
  4. docker compose up -d,Seafile 用 Caddy 自动申请 Let’s Encrypt 证书

访问 https://seafile.example.com。客户端填的地址也是这个。

3.2 无域名(有公网 IP)

直接用 IP 访问,不配 HTTPS(或自签证书):

1
2
SEAFILE_SERVER_HOSTNAME=203.0.113.10
SEAFILE_SERVER_LETSENCRYPT=false

访问 http://203.0.113.10。客户端填 http://203.0.113.10。

注意:用 IP 访问时浏览器会提示”不安全”(HTTP),属于正常。如果要 HTTPS 就得用域名 + 证书,IP 一般申请不到可信证书。

3.3 无公网 IP,通过 FRP 内网穿透

场景:Seafile 跑在家里/内网机器,没有公网 IP。用一个有公网 IP 的服务器(如你的 xyt 那类云主机)做 FRP 中继。

步骤 1:公网服务器上跑 frps(frps.toml):

1
2
3
bindPort = 7000
vhostHTTPPort = 80 # 用于 http 穿透
vhostHTTPSPort = 443 # 用于 https 穿透

启动:frps -c frps.toml

步骤 2:内网机器(Seafile 所在)跑 frpc(frpc.toml):

1
2
3
4
5
6
7
8
9
serverAddr = "公网服务器IP"
serverPort = 7000

[[proxies]]
name = "seafile"
type = "http"
localIP = "127.0.0.1"
localPort = 80 # Seafile 容器映射的宿主机端口
customDomains = ["seafile.example.com"] # 有域名填这里

没有域名时,type 用 tcp 直接映射端口:

1
2
3
4
5
6
[[proxies]]
name = "seafile"
type = "tcp"
localIP = "127.0.0.1"
localPort = 80
remotePort = 8080 # 公网服务器上暴露的端口

步骤 3:配置 Seafile

有域名(customDomains 方式):

1
2
SEAFILE_SERVER_HOSTNAME=seafile.example.com
SEAFILE_SERVER_LETSENCRYPT=false # 证书在 frps/域名上单独处理,Seafile 内部走 http

无域名(tcp 方式):

1
SEAFILE_SERVER_HOSTNAME=公网服务器IP

客户端访问:

  • 有域名:http://seafile.example.com
  • 无域名:http://公网服务器IP:8080

要点:

  • FRP 只转发流量,Seafile 本身还是 SEAFILE_SERVER_HOSTNAME 决定客户端地址,两者必须一致
  • 有域名 + HTTPS 时,证书放在 frps 端(或用域名商/CF 反代),Seafile 内部保持 http,避免内网证书配置复杂化
  • frpc 可以配 systemd 服务开机自启,断线自动重连

四、基础配置

4.1 系统设置

登录 Web 界面后,右上角头像 → 系统管理 → 设置,配置:

站点名称、站点描述
服务器地址(如果 .env 填对了通常自动正确)
注册是否开放(默认关闭,建议保持关闭)

4.2 邮箱通知(可选)

系统管理 → 邮件通知,填 SMTP 服务器、端口、账号密码,用于密码找回、分享通知。没有 SMTP 可以先跳过,不影响核心功能。

五、使用配置

5.1 创建库并上传文件

登录后”我的图书馆”→ 新建图书馆(库),起名后进入,直接拖拽上传文件。Seafile 的库是文件同步和共享的基本单位。

5.2 客户端同步

Seafile 提供 Windows / macOS / Linux / Android / iOS 客户端。

以 Linux 为例(客户端下载自官网):

1
2
# 安装后首次连接填服务器地址 + 账号密码
# 选择一个本地目录作为同步目录,Seafile 会把它和服务器库双向同步

同步要点:

客户端填的地址 = 服务器地址 + 端口(如 https://seafile.example.com)
每个库可以单独选择同步到本地哪个目录
增量同步,只传改动部分,性能比全量好

5.3 共享与权限

Seafile 的共享核心是”库”和”文件夹”两级:

共享库 —— 在库上右键"共享",可共享给指定用户/群组,或生成只读/读写链接
共享文件夹 —— 库内的子文件夹也能单独共享

权限粒度:

读写 —— 对方可改文件,改动会同步回你的库
只读 —— 对方只能下载/预览
上传-only —— 对方只能传文件进库,看不到原有内容(适合收作业/收集资料)

5.4 外部存储挂载(可选)

如果已有对象存储(比如你之前部署的 minio),可以把 S3 兼容存储挂载到 Seafile,把大文件放到对象存储里,减轻本地磁盘压力。

系统管理 → 存储后端,添加 S3 兼容存储:

服务地址(endpoint,如 http://minio.example.com:9000)
Bucket、Access Key、Secret Key
挂载位置(如 /s3-storage)

这样库里的文件可以存到 S3,Seafile 只存元数据。

5.5 文件历史与版本管理

Seafile 默认保留文件历史版本,这是它比普通网盘强的地方:

文件历史 —— 库/文件上"历史"可以查看每次修改、下载旧版本、恢复
版本数量限制 —— 系统管理可设置保留多少版本(默认保留一定数量/时间)

适合当重要文件的版本备份工具,改坏了能一键回滚。

六、验证与常见问题

6.1 部署验证清单

Web 界面能登录(管理员账号)
能创建库、上传/下载文件
客户端能同步
共享链接能访问

6.2 常见问题

502 网关错误:Seafile 还没初始化完成,docker compose logs -f seafile 等日志出现 “Seahub is started” 再访问。

端口冲突:默认 80 端口被占用时,改 caddy.yml 里映射的宿主机端口。

忘记管理员密码:

1
docker compose exec seafile /opt/seafile/seafile-server-latest/reset-admin.sh

按提示重置。

升级 Seafile:修改 .env 里的镜像版本号,docker compose pull && docker compose up -d。升级前备份 /opt/seafile-data。

备份:Seafile 数据全在 SEAFILE_VOLUME(默认 /opt/seafile-data),直接备份该目录即可,数据库也在里面。

小结

Seafile 用 Docker 部署很省心:三个配置文件改一改、docker compose up -d 就起来了。核心概念是”库”,共享、同步、权限都围绕库展开。跟 minio(对象存储)配合使用可以构建一个完整的自建云存储体系——minio 存大文件,Seafile 管同步和协作,各司其职。

... 阅读 ...
文章目录
  1. 一、Seafile 是什么
  2. 二、Docker 部署
    1. 2.1 准备
    2. 2.2 修改 .env
    3. 2.3 启动
  3. 三、访问方式(有域名 / 无域名 / 无公网 IP+FRP)
    1. 3.1 有域名 + 公网 IP(推荐)
    2. 3.2 无域名(有公网 IP)
    3. 3.3 无公网 IP,通过 FRP 内网穿透
  4. 四、基础配置
    1. 4.1 系统设置
    2. 4.2 邮箱通知(可选)
  5. 五、使用配置
    1. 5.1 创建库并上传文件
    2. 5.2 客户端同步
    3. 5.3 共享与权限
    4. 5.4 外部存储挂载(可选)
    5. 5.5 文件历史与版本管理
  6. 六、验证与常见问题
    1. 6.1 部署验证清单
    2. 6.2 常见问题
  7. 小结

评论

加载中...
|