CentOS 7 环境下基于 MariaDB 的 Seafile 私有云盘部署指南
环境准备与目录规划
在 CentOS 7 系统中手动部署 Seafile 服务端时，合理的目录规划能够极大简化后续的升级与维护工作。建议将服务程序与配置文件集中存放在独立的数据分区中。以下示例将安装路径设定为 /srv/seafile。
# 创建基础目录并赋予适当权限
mkdir -p /srv/seafile/archive
cd /srv/seafile
# 假设已获取 seafile-server 安装包，将其解压并归档
tar -xzf seafile-server_*.tar.gz
mv seafile-server_*.tar.gz archive/
完成上述操作后，/srv/seafile 的目录层级如下：
/srv/seafile/
├── archive
│ └── seafile-server_8.0.8_x86-64.tar.gz
└── seafile-server-8.0.8
├── reset-admin.sh
├── runtime
├── seafile
├── seafile.sh
├── seahub
├── seahub.sh
├── setup-seafile-mysql.sh
└── upgrade
这种分离压缩包与运行目录的结构，确保所有配置均沉淀在 conf 目录内，未来版本迭代时只需解压新包并执行升级脚本即可。
系统依赖与数据库初始化
安装基础组件
Seafile 的运行依赖于一系列系统库和 Python 环境。首先配置 EPEL 源并安装核心依赖：
# 配置阿里云 EPEL 镜像
curl -o /etc/yum.repos.d/epel.repo http://mirrors.aliyun.com/repo/epel-7.repo
# 安装编译与图像处理依赖
yum install -y zlib-devel libjpeg-devel freetype-devel mariadb-server
# 安装 Python 3 相关基础库（以 Seafile 8.x 为例）
yum install -y python3 python3-setuptools python3-pip python3-devel mysql-devel gcc gcc-c++
接着，通过 pip 安装 Seahub 所需的 Python 模块。为避免网络超时，可指定国内镜像源：
pip3 install -i https://pypi.tuna.tsinghua.edu.cn/simple \
django==2.2.* future mysqlclient pymysql Pillow pylibmc \
captcha jinja2 sqlalchemy==1.4.3 psd-tools django-pylibmc django-simple-captcha
配置 MariaDB 数据库
启动 MariaDB 服务并设置为开机自启：
systemctl enable --now mariadb
为保障数据安全，需对数据库 root 账户进行安全加固。这里使用 mysqladmin 工具直接修改密码，替代交互式 SQL 操作：
# 将初始空密码修改为强密码（示例：SecurePass#2023）
mysqladmin -u root password 'SecurePass#2023'
# 验证登录并查看当前用户
mysql -u root -p'SecurePass#2023' -e "SELECT CURRENT_USER();"
执行 Seafile 初始化脚本
进入解压后的服务端目录，运行 MySQL 初始化向导：
cd /srv/seafile/seafile-server-8.0.8
./setup-seafile-mysql.sh
脚本执行期间会进行交互式提问。在数据库初始化环节，系统会提供两个选项：
- 选项 1：自动创建 ccnet/seafile/seahub 数据库（需提供刚才设置的 MariaDB root 密码）。
- 选项 2：使用预先手动创建的数据库（适用于对权限控制有严格要求的 DBA 环境）。
对于常规部署，选择选项 1 即可。向导完成后，系统会自动生成 seafile-server-latest 软链接，指向当前版本目录。
服务启停与端口定制
启动核心服务
Seafile 架构分为底层数据服务（Seafile）和前端 Web 服务（Seahub）。首次启动 Seahub 时，系统会强制要求创建超级管理员账户。
# 启动底层文件服务
./seafile.sh start
# 启动 Web 界面服务（默认监听 8000 端口）
./seahub.sh start
自定义 Web 监听端口
若 8000 端口存在冲突，或出于安全考虑需要更改 Web 端口（例如更改为 9000），需按以下流程调整：
# 1. 停止所有运行中的服务
./seahub.sh stop
./seafile.sh stop
# 2. 使用 sed 批量替换 ccnet.conf 中的服务 URL（假设服务器 IP 为 10.0.0.50）
sed -i 's/SERVICE_URL = .*/SERVICE_URL = http:\/\/10.0.0.50:9000/' /srv/seafile/conf/ccnet.conf
# 3. 重新启动服务并指定新端口
./seafile.sh start
./seahub.sh start 9000
注：从 6.3.x 版本起，Seahub 采用 Gunicorn 作为 WSGI 服务器，也可直接编辑 conf/gunicorn.conf 文件中的 bind 参数来固化端口配置。
进程管理与故障排查
常规的启停命令如下：
# 重启服务
./seafile.sh restart
./seahub.sh restart
# 若脚本提示停止失败，可通过进程信号强制干预
pgrep -f "seafile-controller" | xargs kill -9
pgrep -f "gunicorn" | xargs kill -9
网络防火墙策略放行
CentOS 7 默认使用 firewalld 管理网络边界。Seafile 正常运作需要放行 Web 端口（如 9000）以及底层文件传输端口（默认 8082）。
# 批量添加 TCP 端口并设置永久生效
firewall-cmd --permanent --add-port={9000,8082}/tcp
# 重新加载防火墙规则使其生效
firewall-cmd --reload
# 验证当前活动区域的放行策略
firewall-cmd --list-ports
完成上述网络配置后，即可通过浏览器访问 http://<服务器IP>:9000 进入私有云盘的管理与使用界面。对于生产环境，建议后续结合 Nginx 配置 HTTPS 反向代理以提升数据传输安全性。
