Gokapi 临时文件分享:私密初始化、下载次数与完整恢复
固定本地 SQLite 部署,验证匿名下载与管理端权限、次数和过期行为,完整冷备 data/config 并在独立入口恢复。
传一份临时文件,最容易漏掉的是交接结束后的处理:链接还在,原件已经换了版本,服务器里的旧文件也没人清理。Gokapi 适合由维护者上传、生成带有效期或下载次数限制的链接,再交给接收者下载。它不替代长期资料库,也不能收回对方已经保存的副本。
本文固定 Gokapi v2.2.4,使用本地 SQLite 与本地文件目录,管理员账号密码登录。先用无敏感内容的样本,不接 Redis、对象存储、公开文件请求、API 自动上传或 hotlink,也不启用存储加密。HTTPS 和下载密码不等于磁盘文件已加密;需要传医疗、证件、私钥等资料,应先单独评估加密方案和接收流程。
已有 Linux VPS 能容纳临时文件及备份时,可以复用。新机可先按 1 vCPU、1 GiB 内存做小规模选型预算,再根据并发、文件大小和现有负载调整;这是编辑建议,不是应用最低配置或性能实测。地区主要看接收者的访问网络,磁盘按同时有效的文件、上传临时空间和一份完整备份预留,出口流量按实际下载累计核算。普通公网网络即可,不需要住宅 IP。
需要新实例时,可在雨云普通云服务器中核对磁盘、带宽流量、月付及续费条件。先用小文件和接收者的实际网络验证,不为一次传输直接选长账期;域名、备份存储与持续维护也算成本。本文不引用未经当前订单核验的优惠价格。
上传入口与接收入口分开理解
管理员登录后上传文件、设置密码、有效期和下载次数,接收者使用对应下载链接,无需获得管理账号。某个文件能匿名下载,不代表管理端应该匿名开放;退出登录后要分别核对两种入口。
Gokapi 还提供文件请求功能,可让持有特定邀请链接的人上传。本文不启用它,也不把软件描述成“完全没有匿名上传能力”。同样不启用 hotlink,避免图片自动加载等行为消耗下载次数,或把访问控制和浏览器缓存混在一起。
初始化向导首次没有额外的随机访问凭据,因此要先限制为 SSH 私人入口。后续使用 --reconfigure 时才会在日志显示临时访问凭据,两种情形不能混为一谈。密码、下载 URL、配置文件和日志都不应放进公开截图或仓库。
数据和配置各有持久目录
下面以 Ubuntu 24.04、已有 Docker Engine 和 Compose 插件为前提,在 root shell 执行。/srv/gokapi 必须是新路径,已有实例不要重跑初始化。示例容器使用 UID/GID 1000,只把新建 data、config 目录交给这个身份,不修改主机其他服务的目录权限。
set -eu
base=/srv/gokapi
test ! -e "$base"
test ! -L "$base"
install -d -m 0700 "$base"
install -d -m 0700 -o 1000 -g 1000 "$base/data" "$base/config"
cd "$base"
保存 compose.yaml:
services:
gokapi:
image: docker.io/f0rc3/gokapi:v2.2.4@sha256:43cd93b9e1f02d760923f67f6e74e1c4d4a9cccb9b08fa42ad60770333f231eb
user: "1000:1000"
environment:
TZ: UTC
ports:
- "127.0.0.1:53842:53842"
volumes:
- ./data:/app/data
- ./config:/app/config
restart: unless-stopped
/app/config/config.json 保存配置;本例把 SQLite 明确放到 /app/data/gokapi.sqlite,上传文件也放 /app/data。两个目录都要保留,不能只复制下载文件再期待账号、次数和到期状态自动恢复。固定镜像不保证永远无需升级,后续应结合对应发行说明审查版本。
cd /srv/gokapi
chmod 0600 compose.yaml
docker compose config --quiet
docker compose up -d
docker compose logs --tail=80 gokapi
私人初始化,正式分享再用域名
在自己的电脑打开 SSH 隧道,保持窗口开启,再用浏览器访问 http://127.0.0.1:13842/setup:
ssh -N -L 13842:127.0.0.1:53842 user@your-server
向导中选择 SQLite、数据库路径 /app/data/gokapi.sqlite、本地文件存储 /app/data、用户名密码认证,建立独立管理员账号。初始 Public Facing URL 填 http://127.0.0.1:13842/,不启用内置 TLS、存储加密或 IP 下载日志,文件名也不加入下载 URL。Docker 内的监听由此版本处理,主机端的回环绑定已由 Compose 控制,不要自行把容器内监听改为只有 127.0.0.1。
先在私人入口完成下文的小样本验证。正式分享前准备独立域名,例如 files.example.com;若 Caddy 运行在同一宿主机,可配置:
files.example.com {
reverse_proxy 127.0.0.1:53842
}
在现有 Caddy 配置中加入该站点,检查 DNS、证书签发与 80/443 条件,验证后再重载,不覆盖其他站点。Caddy 若在容器里,回环地址不是宿主机,须按实际网络重新配置。不要把 53842 直接开放到公网,也不要把 /app/data 或 /app/config 作为静态目录对外提供。
分享地址由配置中的 ServerUrl 生成。域名已准备好后,先正常停止 Gokapi,备份 config/config.json,只把这个顶层字段改成 https://files.example.com/,保留末尾斜杠及其余全部字段,再启动并验证。不要在修改域名时重建数据库、改盐值或调整加密设置。需要重新跑向导时,必须先停止原实例;临时 --reconfigure 容器完成设置后仍会继续启动服务器,要正常退出它再启原服务,避免两实例共写 SQLite。
正式验收用 HTTPS 匿名窗口打开新生成的测试下载链接,确认域名正确、内容正确;同一窗口再访问管理端,应要求登录。已复制到外部的 localhost 链接不会自动变成新域名,要重新生成并交给接收者。
第一个链接用无敏感内容的样本
先在自己的电脑建立一个普通文本文件,保存原件并计算 SHA-256。上传时设置够测试使用的次数和有效期;例如 5 次、1 天只用于观察,不代表正式交接的推荐值。给文件加独立下载密码,再用退出管理员登录的窗口验证正确密码和错误密码。
接收者下载后再次计算哈希,核对文件名、大小和内容。测试不要从管理界面的专用下载路径代替接收者链接:当前源码中,部分管理/API 下载不增加公开链接计数,二者的权限和用途不同。
此版本在发送文件前就增加下载计数,中断和重试可能消耗次数。计数增加不代表对方完整接收;重要交接仍让接收者确认。不要用唯一一次机会的正式文件来同时测试多个浏览器,也不要因一次网络中断就判断文件损坏或服务器丢数据。
过期规则要真的走到失效一步
用两个样本分别验证时间到期和次数用尽。到期后打开新的匿名窗口,再访问原下载地址,应不能重新取得文件;已经下载的副本和浏览器缓存仍然可能存在。若需要撤回,应立即撤销服务端入口并联系接收者,不能宣称副本已被远程销毁。
链接失效与磁盘物理清理不是同一时刻。v2.2.4 有每小时清理流程,会考虑本地或代理传输的活跃下载状态;启动时也会立即运行清理。不要承诺到期一秒磁盘就释放,更不能把普通删除当成介质安全擦除。
不要在接收者下载过程中手动删除测试文件,再据此推断自动过期能保护所有进行中的传输。观察有效链接、磁盘占用和下载结果后,再制定适合你的文件保留期限。原件保存在长期资料库里,不靠临时服务里的最后一份副本维持业务。
密码与链接走不同通道
下载链接和密码分别交给接收者,不一起贴在公开页面。它们用于限制后来访问,无法阻止已获授权的人复制文件。管理员密码与文件密码使用不同值,管理端始终保留自己的登录保护。
本文选择不启用存储加密,因此主机管理员或取得磁盘副本的人可能读取文件。HTTPS 保护传输链路,下载密码限制入口,两者都不把本地文件变成密文。若需要 Gokapi 的加密功能,先看固定版本说明并另做上传、下载和恢复验证;官方明确提醒,改变加密设置会删除已有加密文件,不能把它当成无影响的开关。浏览器端加密也有单独的兼容条件,不在本文的样本流程中声称通过。
分享 URL 本身也是访问凭证的一部分。不要把含真实 ID 的链接放进公开工单、统计标签或截图;文件名也可能透露私人内容。停止使用某个账号或 API 时及时撤销对应凭据,API 自动化另行核验,不复用管理员口令写脚本。
大文件先检查代理与磁盘条件
小文件成功后,再逐步增加到你的常用大小。检查上传临时空间、data 所在磁盘、应用上传限制、代理超时和网络重试,不要一开始把所有限制设为无限。正在传输的数据还会占用带宽和出口流量,与别的网站共用机器时要观察影响。
普通本地模式下,接收者下载主要消耗这台 VPS 的出口;同一个文件重复下载也可能累计流量。选型看实际订单的带宽、流量口径与超额处理,不把软件支持大文件理解成服务器传输免费。
对象存储和 Redis 是另外的部署范围。接入后,本文的本地双目录备份不再足以证明远端文件或数据库已保存;要重新设计权限、持久化、清理、预签名链接与恢复,不直接套用本地流程。
备份可能重新带回已经过期的文件
备份含账号、配置、分享状态和文件,应放在受保护的存储中,并设置自己的保留期限。服务端删除文件不会修改已经生成的备份。恢复旧副本时,文件仍按原有效期和剩余次数判断;此版本启动即清理,已经到期的文件可能很快从恢复实例中移除。
下面脚本仅适用于本例单实例、本地 SQLite、没有其他进程写这两目录的环境,要求原服务正在运行。它停止服务并确认没有 OOM 或异常退出后才打包,失败时尝试启动原服务;生成的 tar 包本身没有加密,应随后加密转移到异机,不能当作公开下载文件。
cd /srv/gokapi
bash <<'SH'
set -eu
umask 077
set -- data config compose.yaml
if [ -e .env ] || [ -L .env ]; then
test -f .env
test ! -L .env
set -- "$@" .env
fi
cid=$(docker compose ps -q gokapi)
test -n "$cid"
test "$(docker inspect -f '{{.State.Running}}' "$cid")" = true
restart=0
finish() {
rc=$?
trap - EXIT
if [ "$restart" = 1 ]; then
docker compose start gokapi || rc=1
fi
exit "$rc"
}
trap finish EXIT
trap 'exit 130' INT
trap 'exit 143' TERM
restart=1
docker compose stop -t 45 gokapi
test "$(docker inspect -f '{{.State.Running}}' "$cid")" = false
test "$(docker inspect -f '{{.State.OOMKilled}}' "$cid")" = false
code=$(docker inspect -f '{{.State.ExitCode}}' "$cid")
case "$code" in 0|143) ;; *) exit 1 ;; esac
mkdir -p backups
dest="backups/$(date -u +%Y%m%dT%H%M%SZ)-$$"
mkdir -m 0700 "$dest"
tar -czf "$dest/gokapi.tar.gz" "$@"
tar -tzf "$dest/gokapi.tar.gz" >/dev/null
(cd "$dest" && sha256sum gokapi.tar.gz > SHA256SUMS)
printf '%s\n' "$dest"
SH
docker compose logs --tail=50 gokapi
保留一份仍在有效期内、次数充足的测试文件,并记住原文件哈希。到备份目录执行 sha256sum -c SHA256SUMS 后,在 root shell 用新目录恢复;把 BACKUP 换成可信的自有归档,不能覆盖原实例。
set -eu
BACKUP=/srv/gokapi/backups/REPLACE_WITH_BACKUP/gokapi.tar.gz
target=/srv/gokapi-restore
test -f "$BACKUP"
test ! -e "$target"
test ! -L "$target"
install -d -m 0700 "$target"
tar --numeric-owner -xzf "$BACKUP" -C "$target"
cd "$target"
python3 - <<'PY'
from pathlib import Path
import json
p = Path('compose.yaml')
s = p.read_text()
old = '127.0.0.1:53842:53842'
assert s.count(old) == 1
p.write_text(s.replace(old, '127.0.0.1:53843:53842'))
p = Path('config/config.json')
with p.open('r+', encoding='utf-8') as f:
d = json.load(f)
assert isinstance(d.get('ServerUrl'), str)
d['ServerUrl'] = 'http://127.0.0.1:13843/'
f.seek(0)
json.dump(d, f, ensure_ascii=False, indent=2)
f.write('\n')
f.truncate()
PY
docker compose -p gokapi-restore config --quiet
docker compose -p gokapi-restore up -d
另建 ssh -N -L 13843:127.0.0.1:53843 user@your-server,只从自己的电脑访问恢复副本。上面只改了副本端口和 ServerUrl,避免恢复环境复制出的链接指回正式域名。回环入口限制入站,不能宣称隔离了所有出站网络;本例也没有远端存储或集成需要联络。
在副本核对原管理员登录、匿名管理端拒绝、未过期测试链接的密码与下载哈希,以及一个已过期链接的失效状态。不要修改旧文件的过期时间来把它变成“恢复成功”。完成后停止副本 docker compose -p gokapi-restore stop,保留冷档及验证结果。
升级前阅读新版本说明,保存匹配的镜像摘要、Compose、配置和数据。新版写过数据库后,直接降回旧镜像不等于完整回滚;先从成套旧副本验证,再安排正式切换。
推荐码:KuZhuJi




