# 前言介绍
在企业数字化转型过程中，官网下载中心是一个高频使用的功能模块。无论是产品手册、软件安装包、技术文档还是营销素材，都需要一个集中管理、权限可控的下载平台。很多企业初期只是将文件直接放在服务器目录下，或者使用网盘链接，这种方式不仅管理混乱，而且无法控制谁可以下载、谁可以上传，容易造成敏感文件泄露或服务器资源被滥用。
本教程将手把手教你从零搭建一个功能完整的官网下载中心，重点解决文件上传与下载的权限控制问题。整个搭建过程基于常见的Web服务器环境（Nginx + PHP），使用开源的FileGator文件管理器作为核心工具，无需开发基础，按照步骤操作即可完成。
# 前置准备
在开始搭建之前，请确保你已经具备以下条件：
1. **一台云服务器或虚拟主机**：建议使用Linux系统（CentOS 7/8 或 Ubuntu 20.04/22.04），服务器配置至少1核2G内存，硬盘空间根据文件存储需求选择，建议至少20GB。
2. **域名**：一个已解析到服务器IP的域名，例如 download.yourcompany.com。
3. **SSH客户端**：推荐使用Xshell、Putty或Termius（Mac用户），用于远程连接服务器。
4. **Web环境**：服务器上已安装Nginx + PHP 7.4以上版本 + MySQL/MariaDB（非必需，但推荐用于用户管理）。如果未安装，本教程会提供安装命令。
5. **FileGator安装包**：从官网 https://filegator.io 下载最新版本，或者使用wget命令直接下载到服务器。
6. **基础Linux命令知识**：了解cd、ls、chmod、vim等基础命令用法。
# 分步操作步骤
## 第一步：安装Web运行环境
1. 使用SSH客户端连接到服务器，输入以下命令更新系统包：
```
sudo apt update && sudo apt upgrade -y # Ubuntu/Debian系统
sudo yum update -y # CentOS/RHEL系统
```
2. 安装Nginx Web服务器：
```
sudo apt install nginx -y # Ubuntu/Debian
sudo yum install nginx -y # CentOS
```
3. 启动Nginx并设置开机自启：
```
sudo systemctl start nginx
sudo systemctl enable nginx
```
4. 安装PHP及必要扩展（FileGator需要PHP 7.4+，推荐PHP 8.1）：
```
sudo apt install php8.1-fpm php8.1-mysql php8.1-xml php8.1-mbstring php8.1-zip php8.1-curl -y # Ubuntu添加PHP源后执行
```
如果是CentOS系统，先安装EPEL和Remi源：
```
sudo yum install epel-release -y
sudo yum install https://rpms.remirepo.net/enterprise/remi-release-7.rpm -y # CentOS 7
sudo yum install https://rpms.remirepo.net/enterprise/remi-release-8.rpm -y # CentOS 8
sudo yum module reset php -y
sudo yum module enable php:remi-8.1 -y
sudo yum install php php-fpm php-mysqlnd php-xml php-mbstring php-zip php-curl -y
```
5. 启动PHP-FPM并设置开机自启：
```
sudo systemctl start php8.1-fpm # Ubuntu
sudo systemctl start php-fpm # CentOS
sudo systemctl enable php8.1-fpm # Ubuntu
sudo systemctl enable php-fpm # CentOS
```
6. 验证PHP是否安装成功，创建一个测试文件：
```
echo "" | sudo tee /var/www/html/info.php
```
然后在浏览器访问 http://你的服务器IP/info.php，如果看到PHP信息页面，说明环境安装成功。测试完成后删除该文件：
```
sudo rm /var/www/html/info.php
```
## 第二步：下载并部署FileGator
1. 进入Web根目录（通常为/var/www/html）：
```
cd /var/www/html
```
2. 下载FileGator最新版本（建议从GitHub获取）：
```
sudo wget https://github.com/filegator/filegator/releases/latest/download/filegator.zip
```
3. 解压安装包：
```
sudo unzip filegator.zip -d filegator
```
4. 设置目录权限，确保Web服务器有写入权限：
```
sudo chown -R www-data:www-data /var/www/html/filegator # Ubuntu/Debian
sudo chown -R nginx:nginx /var/www/html/filegator # CentOS/RHEL
sudo chmod -R 755 /var/www/html/filegator
sudo chmod -R 775 /var/www/html/filegator/private # 私有目录需要可写
sudo chmod -R 775 /var/www/html/filegator/repository # 文件存储目录需要可写
```
5. 进入FileGator目录，复制配置文件：
```
cd /var/www/html/filegator
sudo cp configuration.php.example configuration.php
```
6. 编辑配置文件，设置基本参数：
```
sudo vim configuration.php
```
找到以下配置项并修改：
- `'app_name' => '官网下载中心'` // 修改为你想要的站点名称
- `'app_timezone' => 'Asia/Shanghai'` // 设置时区
- `'language' => 'zh-CN'` // 设置语言为中文
- `'frontend_config' => ['app_name' => '官网下载中心', 'upload' => false]` // 默认关闭前端上传功能，后续权限控制会开启
保存并退出（vim中按Esc，输入:wq回车）。
## 第三步：配置Nginx虚拟主机
1. 创建Nginx站点配置文件：
```
sudo vim /etc/nginx/sites-available/download.yourcompany.com # Ubuntu
sudo vim /etc/nginx/conf.d/download.yourcompany.com.conf # CentOS
```
2. 写入以下配置内容（将域名替换为你自己的域名，路径根据实际调整）：
```nginx
server {
listen 80;
server_name download.yourcompany.com;
root /var/www/html/filegator;
index index.php index.html;
# 设置上传文件大小限制（根据需求调整，这里设置为200MB）
client_max_body_size 200M;
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location ~ \.php$ {
include snippets/fastcgi-php.conf; # Ubuntu路径
# include fastcgi.conf; # CentOS用这个
fastcgi_pass unix:/var/run/php/php8.1-fpm.sock; # Ubuntu
# fastcgi_pass unix:/var/run/php-fpm/www.sock; # CentOS用这个
}
# 禁止访问私有目录
location ~ /(private|repository) {
internal;
}
# 缓存静态资源
location ~* \.(jpg|jpeg|png|gif|ico|css|js)$ {
expires 30d;
add_header Cache-Control "public, no-transform";
}
}
```
3. 启用站点配置（Ubuntu需要创建软链接）：
```
sudo ln -s /etc/nginx/sites-available/download.yourcompany.com /etc/nginx/sites-enabled/ # Ubuntu
```
4. 测试配置是否正确：
```
sudo nginx -t
```
5. 如果测试通过，重启Nginx：
```
sudo systemctl restart nginx
```
6. 配置防火墙，开放80端口（如果启用了防火墙）：
```
sudo ufw allow 80/tcp # Ubuntu
sudo firewall-cmd --permanent --add-port=80/tcp # CentOS
sudo firewall-cmd --reload
```
## 第四步：初始化FileGator并创建管理员账号
1. 在浏览器中访问 http://download.yourcompany.com，你会看到FileGator的安装向导页面。
2. 页面会检测服务器环境是否满足要求，确保所有绿色勾号都显示通过。如果有红色叉号，根据提示安装缺失的PHP扩展或修改权限。
3. 点击“下一步”进入数据库配置。FileGator支持SQLite和MySQL。对于小规模使用，选择SQLite即可（无需额外配置数据库）。如果需要多用户管理，建议选择MySQL：
- 选择“MySQL”后，填写数据库主机（通常为localhost）、数据库名、用户名和密码。
- 如果你还没有创建MySQL数据库，先登录MySQL创建：
```
sudo mysql -u root -p
CREATE DATABASE filegator;
CREATE USER 'filegator_user'@'localhost' IDENTIFIED BY '你的密码';
GRANT ALL PRIVILEGES ON filegator.* TO 'filegator_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;
```
4. 点击“下一步”创建管理员账号：
- 用户名：admin（建议修改为其他名称）
- 密码：设置一个强密码（至少8位，包含大小写字母和数字）
- 邮箱：填写管理员邮箱
5. 点击“安装”完成初始化。安装成功后，系统会提示删除安装目录：
```
sudo rm -rf /var/www/html/filegator/installation
```
6. 使用刚才创建的管理员账号登录后台。
## 第五步：配置文件上传与下载权限
1. 登录后台后，点击左侧菜单“用户管理”，你会看到默认的管理员账号。FileGator的权限体系分为三个角色：
- **管理员**：拥有所有权限，包括上传、下载、删除、管理用户
- **用户**：可以上传和下载文件，但不能管理其他用户
- **访客**：只能下载公开文件，不能上传
2. **创建普通用户（用于上传文件的人员）**：
- 点击“添加用户”
- 用户名：例如“uploader01”
- 密码：设置独立密码
- 角色：选择“用户”
- 点击“保存”
3. **配置访客下载权限**：
- 点击左侧菜单“设置”
- 找到“访客权限”部分
- 勾选“允许访客下载文件” - 这样未登录用户也能下载文件
- 取消勾选“允许访客上传文件” - 防止匿名上传
- 点击“保存设置”
4. **设置文件目录权限**：
- 点击左侧菜单“文件管理”
- 你会看到默认的根目录“/”
- 点击目录右侧的“权限”图标（锁形图标）
- 在弹出的窗口中，你可以为每个目录单独设置权限：
- **公开下载**：勾选后，该目录下的文件所有访客都可以下载
- **需要登录**：勾选后，只有登录用户才能下载
- **允许上传**：勾选后，该目录允许用户上传文件
- 例如，创建一个“产品手册”目录，设置为“公开下载”和“允许上传”，这样上传者可以上传文件，所有访客可以下载
5. **配置上传文件类型限制**：
- 在“设置”页面中，找到“文件上传”部分
- 在“允许的文件类型”输入框中，填写允许上传的扩展名，用逗号分隔，例如：pdf,doc,docx,xls,xlsx,zip,rar,exe,msi
- 在“最大文件大小”输入框中，填写允许上传的最大值，例如200MB
- 点击“保存设置”
6. **配置下载限速（防止服务器带宽被占满）**：
- 在Nginx配置中增加限速设置，编辑站点配置文件：
```
sudo vim /etc/nginx/sites-available/download.yourcompany.com
```
- 在server块中添加以下内容：
```nginx
# 限制每个IP的下载速度为500KB/s
limit_rate 500k;
# 限制每个IP的连接数为5
limit_conn addr 5;
```
- 保存后重启Nginx：
```
sudo systemctl restart nginx
```
## 第六步：测试上传与下载功能
1. **测试文件上传**：
- 使用普通用户账号（例如uploader01）登录下载中心
- 进入你之前设置好的可上传目录（例如“产品手册”）
- 点击页面右上角的“上传”按钮
- 选择文件，点击“开始上传”
- 上传成功后，文件会显示在目录列表中
2. **测试文件下载**：
- 退出登录，以访客身份访问下载中心
- 进入“产品手册”目录
- 点击文件旁边的“下载”按钮
- 如果配置正确，文件应该开始下载，且下载速度受到限速配置的限制
3. **测试权限控制**：
- 创建一个新目录，设置为“需要登录”
- 以访客身份访问该目录，应该看不到文件列表或无法下载
- 登录后再次访问，应该可以正常下载
4. **测试文件删除权限**：
- 以普通用户身份登录，尝试删除其他用户上传的文件
- 默认情况下，普通用户只能删除自己上传的文件
- 管理员可以删除所有文件
# 常见问题
**问题1：上传文件时提示“413 Request Entity Too Large”**
原因：Nginx默认上传大小限制为1MB。
解决方法：按照第三步中的配置，在Nginx站点配置中添加 `client_max_body_size 200M;`，然后重启Nginx。
**问题2：访问下载中心显示503或空白页**
原因：PHP-FPM服务未运行或Nginx与PHP通信配置错误。
解决方法：检查PHP-FPM状态 `sudo systemctl status php8.1-fpm`，确认sock文件路径是否正确。在Nginx配置中，fastcgi_pass的路径必须与PHP-FPM的实际监听路径一致。
**问题3：文件上传后无法在目录中看到**
原因：文件存储目录权限不足，或者PHP用户无法写入。
解决方法：检查repository目录权限 `ls -la /var/www/html/filegator/repository`，确保所有者是www-data（Ubuntu）或nginx（CentOS）。如果权限不对，执行 `sudo chown -R www-data:www-data /var/www/html/filegator/repository`。
**问题4：访客可以下载但无法看到文件列表**
原因：FileGator默认隐藏文件列表，只提供直接下载链接。
解决方法：在后台“设置”中，找到“访客权限”，勾选“允许访客查看文件列表”。或者在前端模板中修改显示逻辑。
**问题5：下载速度太慢或太快**
原因：Nginx限速配置不准确，或者未生效。
解决方法：检查Nginx配置中limit_rate指令是否在正确的上下文中。如果限速未生效，尝试在location块中添加 `limit_rate 500k;`。注意，限速是对每个连接生效，如果用户使用多线程下载工具，实际速度会叠加。
**问题6：忘记管理员密码**
解决方法：通过数据库重置。如果使用SQLite，数据库文件在 `/var/www/html/filegator/private/filegator.sqlite`。使用SQLite客户端连接后，执行 `UPDATE users SET password = '$2y$10$...' WHERE username = 'admin';` 其中密码哈希值需要通过PHP的password_hash函数生成。更简单的方法是重新安装FileGator（注意备份文件），或者通过配置文件中的密码重置功能（如果有）。
**问题7：上传的文件名包含中文导致乱码**
原因：服务器区域设置或PHP编码问题。
解决方法：在FileGator的configuration.php中设置 `'app_charset' => 'UTF-8'`，并确保服务器系统语言为UTF-8。上传前在客户端将文件名转换为UTF-8编码。
# 收尾总结
通过以上六个步骤，你已经成功搭建了一个功能完整的官网下载中心，并实现了文件上传与下载的精细化权限控制。整个系统基于FileGator开源项目，具有以下核心能力：
- **角色权限体系**：管理员、普通用户、访客三级权限，每个角色可独立配置上传、下载、查看、删除等操作。
- **目录级权限控制**：可以为每个文件夹单独设置公开下载、需要登录、允许上传等权限，灵活应对不同业务场景。
- **上传限制**：支持文件类型白名单、文件大小上限、上传频率控制，防止服务器被恶意上传占用。
- **下载保护**：支持下载限速、连接数限制、私有目录隐藏，有效保护服务器带宽和文件安全。
- **多用户管理**：可以创建多个上传账号，每个账号只能管理自己的文件，管理员可以全局管控。
后续你可以根据业务需求进一步扩展：集成LDAP/AD用户认证、对接CDN加速下载、添加文件版本管理、实现文件预览功能（PDF/图片/视频在线查看）等。定期检查服务器日志和文件存储空间，及时清理过期文件，确保下载中心长期稳定运行。