# 文件服务器(download.zmm.show) > 部署日期:2026-11-16 状态:**已上线可用** > 访问地址:**http://download.zmm.show/** --- ## 1. 架构速览 | 项目 | 值 | |---|---| | 服务器 | `141.164.50.58`(CentOS Stream 10,SELinux Enforcing) | | 站点根目录 | `/srv/files` | | Web 服务 | nginx 1.26.3 + `ngx_http_fancyindex_module 0.5.2`(自编译动态模块) | | 监听 | 80(`firewalld` 已放行 http),443 未开放 | | 时区 | `Asia/Shanghai`(原为 UTC,已修正,页面时间不再差 8 小时) | | 内存占用 | nginx 约 4.4 MB | | 磁盘 | 根分区 25G,已用 8.4G | 旧机 `47.114.35.165` 上的同名服务已 **stop + disable**,文件保留(`/srv/files`,101M 测试数据)。 ### 为什么不用现成的 caddy / docker 该机已跑着 caddy(8999) 与两个 uvicorn 服务,且 `auto_https` 关闭用于反代其他站点;冒然改它的 Caddyfile 有影响现有服务的风险。因此 80 端口由独立 nginx 承载,互不干扰。 ### fancyindex 为什么是"自编译" CentOS Stream 10 的 EPEL 没有 `nginx-mod-http-fancyindex` 包,只能从源码编译。关键点是 nginx 官方包自带 `--with-compat`,所以用同版本源码 + `--with-compat` 编出的动态模块 ABI 兼容: ```bash curl -fsSLO https://nginx.org/download/nginx-1.26.3.tar.gz && tar xf nginx-1.26.3.tar.gz curl -fsSL https://github.com/aperezdc/ngx-fancyindex/archive/refs/tags/v0.5.2.tar.gz | tar xz cd nginx-1.26.3 && ./configure --with-compat --add-dynamic-module=../ngx-fancyindex-0.5.2 make modules && cp objs/*.so /usr/lib64/nginx/modules/ echo 'load_module "/usr/lib64/nginx/modules/ngx_http_fancyindex_module.so";' > /usr/share/nginx/modules/mod-http-fancyindex.conf ``` **升级 nginx 大版本后需按新版本重编此模块**,否则会因 ABI 不匹配启动失败。 --- ## 2. 文件怎么上传(三种方式) SSH 免密已配好:私钥 `C:\SPB_Data\.ssh\zmm_files_ed25519`,公钥已写入服务器 `root` 的 `authorized_keys`。 ### 方式一:一键脚本(最省事) ```bash cd C:/Users/zmm/WorkBuddy/2026-11-16-10-19-18/deploy ./upload.sh ./build/App-1.2.0.zip # 默认进 official_releases/ ./upload.sh ./dist official_releases # 整个目录 ./upload.sh ./手册.pdf docs # 指定子目录 ./upload.sh ./data "" # 传到根目录 ``` 脚本会自动选 `rsync`(无则退化为 `scp -r`)、修权限、并打印最终访问链接。 ### 方式二:rsync(大目录 / 断点续传,推荐) ```bash rsync -avP -e "ssh -i ~/.ssh/zmm_files_ed25519" \ ./dist/ root@141.164.50.58:/srv/files/official_releases/ ``` 末尾斜杠含义要分清:`./dist/` 是"把目录内容传进去",`./dist` 是"把 dist 目录本身传进去"。 ### 方式三:scp(单个文件) ```bash scp -i ~/.ssh/zmm_files_ed25519 App.zip root@141.164.50.58:/srv/files/official_releases/ ``` ### 上传后必做(否则可能 403) ```bash ssh -i ~/.ssh/zmm_files_ed25519 root@141.164.50.58 "chmod -R a+rX /srv/files" ``` `upload.sh` 与 rsync 方式已自动处理,纯 scp 手动传时容易漏。 --- ## 3. 目录规划 ``` /srv/files/ ├── official_releases/ 正式发布版本(安装包、固件、发布包) ├── tools/ 工具与脚本 ├── docs/ 文档、手册 ├── archive/ 历史归档 ├── README.txt 根目录说明(访客可见) └── .theme/ 页面主题(header.html / footer.html),列表里自动隐藏 ``` --- ## 4. 日常维护 ```bash # 改完配置校验并重载 ssh root@141.164.50.58 "nginx -t && systemctl reload nginx" # 看访问日志(含客户端 IP、状态码、流量) ssh root@141.164.50.58 "tail -f /var/log/nginx/files_access.log" # 看错误日志 ssh root@141.164.50.58 "tail -50 /var/log/nginx/files_error.log" # 加一个新分类目录 ssh root@141.164.50.58 "mkdir -p /srv/files/firmware && chmod 755 /srv/files/firmware" ``` ### 页面主题在哪改 `/srv/files/.theme/header.html`(顶栏 + 全部 CSS + 表格开头)与 `footer.html`(面包屑 / 图标注入 / 搜索过滤 / 复制链接的 JS)。改完无需 reload,刷新即可(`expires 1h` 可能让浏览器缓存,强刷 Ctrl+F5)。 ### 如果要加访问密码 ```bash ssh root@141.164.50.58 dnf install -y httpd-tools htpasswd -c /etc/nginx/.htpasswd youruser # 按提示输入密码 ``` 然后在 `/etc/nginx/conf.d/files.conf` 的 `location / {` 里加两行: ```nginx auth_basic "Restricted"; auth_basic_user_file /etc/nginx/.htpasswd; ``` `nginx -t && systemctl reload nginx` 生效。 --- ## 5. 已验证项(2026-11-16 实测) | 检查项 | 结果 | |---|---| | 公网 HTTP 访问 | `HTTP/1.1 200 OK`,`Server: nginx` | | 域名解析 | `download.zmm.show → 141.164.50.58` | | 目录列表渲染 | 表头中文(名称/大小/修改时间)、图标按类型区分、面包屑正常 | | 断点续传 | `Range` 请求返回 **206**,支持多线程下载器 | | 中文目录/文件名 | 200,显示无乱码 | | SELinux | `ausearch -m avc` **0 条拒绝** | | fd 限制 | master 进程 `Max open files 65535`(已加 systemd drop-in,消除 worker_connections 警告) | | 错误日志 | 空 | --- ## 6. 已知限制 1. **只有 HTTP,没有 HTTPS**。443 端口未在安全组/firewalld 开放。要上 HTTPS 需要:放行 443 → 签证书(Let's Encrypt)→ 加 443 server 块。域名已解析,随时可做。 2. **没有网页上传界面**。当前是只读站点,上传走 SSH(rsync/scp)。如需浏览器拖拽上传,要额外加 WebDAV 或 filebrowser 之类的前端。 3. `.theme/header.html` 可被直接访问(返回的是 CSS/JS,无敏感信息,且列表里不显示入口)。fancyindex 的子请求机制要求不能设 `internal`。 4. 该机 `firewalld` 处于 active,**新增端口都要 `firewall-cmd --permanent --add-port` 再 reload**,否则外网访问不通(本次 80 就踩了这个坑)。 5. 服务器内存仅 949 MB 且已跑 uvicorn/caddy,不要再在其上跑编译或大内存服务。 --- ## 7. 部署脚本(本目录) | 文件 | 用途 | |---|---| | `upload.sh` | 上传工具(日常用这个) | | `nginx-centos.conf` | 主配置,对应 `/etc/nginx/nginx.conf` | | `files-site-centos.conf` | 站点配置,对应 `/etc/nginx/conf.d/files.conf` | | `header.html` / `footer.html` | 页面主题,对应 `/srv/files/.theme/` | | `deploy_centos.py` | 一键部署(上传文件 + SELinux 标签 + 启服务) | | `run.py` / `rmt.py` | 远程执行小工具(密钥优先,失败回退密码) | | `shots/*.png` | 页面效果截图 |