想自己搭个下载站？这套源码结构简单、上线快

自己搭个下载站？飞书下载这套源码结构简单、上线快

去年帮朋友搞个内部资源分享站点，翻遍了网上各种现成的下载系统，要么功能太重、要么乱收费。后来无意间试了飞书下载这套源码，发现它有个很实在的特点：代码结构清爽，PHP 单文件就能跑起来，不需要折腾复杂的框架。当时从下载到部署上线，前后不到半小时，连我这种后端半吊子都觉得顺手。这套源码适合用来做小团队的软件包分发、个人博客的附件下载页面，或者干脆给客户搭个简单的资源站。

下载与安装步骤

找源码本身不复杂，你直接点本页下载按钮就能拿到最新的压缩包。解压后你会看到一个非常朴素的目录，核心文件就几个：index.php 是首页展示、download.php 处理下载逻辑、config.php 放配置参数。没有多余的花哨东西，连 CSS 都是内嵌的，这对我这种懒得折腾前端的人来说很友好。

安装时唯一要注意的就是 PHP 版本。飞书下载这套源码要求 PHP 7.2 以上，我一开始没注意，在个几年前的 PHP 5.6 服务器上直接报错，提示某个函数未定义。换成 PHP 7.4 后就一切正常了。上传方式也简单，用 FTP 或者面板的文件管理器整个解压后的文件夹丢到网站根目录就行。如果你有自己绑定的域名，记得解析好之后等几分钟生效。

配置文件 config.php 里有个小坑——它默认的数据库连接是空的，因为这套源码走的是文件缓存，不是传统的 MySQL。这对新手反而是好事，省得去装数据库。但如果你要管理大量文件，还是建议改成 MySQL 模式，否则缓存文件多了之后查找速度会变慢。具体切换方法在代码注释里写了，把那几行注解去掉就行。

后台管理与文件上传

这套源码的后台入口是 admin.php，默认账号密码都是 admin。第一次登录时赶紧改掉，网上随便一搜就能搜到默认密码，我另一个站就被扫过几次，后来改了复杂点的才消停。后台界面特别朴素，就几个按钮：添加文件、编辑文件信息、查看统计、清空缓存，功能少但每个都能直接用。

上传文件时你可以直接拖拽过去，或者点选择文件。我试过上传一个 1.2GB 的 ISO 镜像文件，本来担心会超时或者中断，结果居然稳稳传完了，这得归功于它底层的分段上传逻辑。但有一点必须提醒：服务器 PHP 配置里的 upload_max_filesize 和 post_max_size 这两个参数有限制，默认通常是 2M 或 8M，你得手动改大。我是在宝塔面板的 PHP 设置里直接拉到 2048M，不然大文件上传到一半就断了。改完之后重启一下 PHP 服务才生效。

文件上传后可以设置下载次数限制和有效期。比如你只想让这个链接在 7 天内有效、最多下载 50 次，直接在后台填数字就行。这个功能我用来发过给客户的内测包，保证了安全，也让对方不用老是催我续期。另外每个文件还可以加上简短描述，默认会显示在下载按钮下面。

页面定制与多语言支持

默认的首页设计走的是极简风，黑底白字加几个粗体标题，看着不丑但有点单调。如果你想换样式，直接改 index.php 里那段内嵌 CSS 就行，比如把背景色改成浅灰、加大按钮圆角。我花十分钟就调了个和公司官网风格一致的配色，连公司 LOGO 都放上去了。注意别改错括号或者漏了分号，最好复制一份做备份。

关于多语言，这套源码内置了简体中文和英文两个语言包，位于 lang 目录下。你只要在 config.php 里把语言选项改成 'en' 或者 'zh_CN'，前端显示就会切换。我自己试过切换成英文后发给海外用户，反馈说界面挺正常的。如果你需要别的语言，比如日语、韩语，直接复制一份语言文件然后改里面的对应字段就行，不需要动核心代码。

还有个小技巧：首页底部的 footer 信息和默认的“联系我们”文字可以在同一份语言文件里改。我之前不小心把版权年份写成 2022，被人提醒才发现，改起来倒方便，直接在 lang 文件里搜索那个字符串替换掉。如果你怕改乱，建议用 Notepad++ 或者 VS Code 这种带语法高亮的编辑器操作。

下载限速与防盗链设置

飞书下载的下载限速功能藏在 download.php 里，默认是关闭的。你可以手动改一下代码开头的 $speed_limit 变量，单位是 KB/s，比如填 500 就代表限速 500KB/s。我试过限到 100KB/s，发现下载大文件时用户会有点不耐烦，所以建议给普通注册用户开 1024，付费用户不限速。当然这个需要你自己根据服务器带宽调整。

防盗链的设置更有意思。源码自带 Referer 白名单功能，在你 config.php 里添加允许来源的域名列表，比如只允许你的主站域名、或者某个内部 IP 范围。这样别的地方直接拿链接来盗下载就会返回 403 错误。我遇到过有人把资源链接发到第三方论坛，开了白名单后就安静多了。

还有一个细节：如果你在下载页面用了 CDN 加速，记得把 CDN 的域名也加到白名单里，否则通过 CDN 回源的请求会被当成盗链拦掉。我刚开始没注意，结果测试下载时总报错，排查了半天才发现是这个原因。

性能优化与缓存机制

这套源码的缓存默认是用文件来做，每次下载请求都会生成一个缓存记录，存到 cache 目录下。如果你的站每天只有几百次下载，基本不用担心。但要是流量突然上来——比如你发了个资源帖子被转到热门论坛——缓存文件会成几何级增长，拖慢页面加载。我有个站就因为一个 2GB 的软件包被疯传，cache 目录里塞了几万个小文件，打开后台响应慢得要死。

解决方式有两种：一是定期手动清空 cache 目录里的过期文件，或者写个 crontab 定时任务自动清理。二是切换到 Redis 或 MySQL 做缓存，源码里提供了相关的适配代码，按注释改就行。我自己后来换了 MySQL，查询速度稳定很多，但需要额外维护一个数据库，看你能不能接受。

别忘了给下载文件本身也做一下优化。比如你放的安装包是 zip 格式，可以考虑提前用 7-Zip 压缩成更高效的格式，或者设置合理的分卷大小。源码本身不自动对文件进行压缩处理，但你可以上传前自己处理。

常见问题与排错经验

部署后最常碰到的问题就是 404 错误，通常是伪静态规则没配好。飞书下载这套源码用的是 apache 自带的 .htaccess 规则，但如果你用的是 Nginx，就需要手动转换一下。我把规则改写成 Nginx 格式后放到站点配置里，大概长这样：location / { try_files $uri $uri/ /index.php?$args; }。不同版本可能有细微差别，你可以看看源码根目录下的 nginx.txt 文件，里面有现成的案例。

另一个坑是文件上传后在前端点下载按钮没反应。这时候先检查 PHP 的 error_log，大部分原因是上传的文件超过了服务器允许的最大值，或者服务器磁盘满了。有次我忘了清理某个目录里的临时文件，导致 /tmp 分区爆满，上传到一半就停掉。建议后台定期检查磁盘使用率，别让这种低级问题坑了自己。

还有个经常被问到的问题：能不能支持分卷下载？比如一个 5GB 的包、拆分成多个小包。目前这套代码不支持自动分卷，你只能手动上传多个文件，然后在后台把它们归到一个分类里。如果你有这个需求，可以考虑在 index.php 页面上加个说明，让用户按顺序下载。