一个自托管的小站,
存文件,也存推文。

Lighthouse Server 提供两类能力:通用文件仓库(上传 / 下载 / 列表,带上传时间) 与 Twitter/X 推文归档(贴链接自动抓取,或直接 JSON 导入,网页与手机都能看)。 下面这张页面就是全部功能的入口。

能做什么

各个能力,点开即用。

怎么用

人看浏览器,Agent 看接口,两边指向同一套数据。

🖱️

如果你是人

1. 打开 文件库,拖拽上传,链接一键复制。
2. 打开 时间线,贴一条推文链接点 Archive,等进度条走完就能刷到。
3. 手机上装 Expo 客户端,在 Settings 里填服务器地址和 API Token 即可。

浏览器 / iOS · Android
⌨️

如果你是 Agent

1. 读 /llms.txt 或 /api/manifest 了解全部接口。
2. 写操作带 Authorization: Bearer <TOKEN>,读操作免鉴权。
3. 结构化数据直接 POST /api/tweets/batch 批量导入,无需 gallery-dl。

curl / SDK / OpenAPI

接口一览

完整文档见 Agent 页 或 Swagger UI。🔒 表示需要 Bearer Token。

方法路径说明
POST/api/files/upload🔒 上传任意文件,返回 file_id + 下载链接 + 上传时间
GET/api/files列出文件(page / q / order=recent|oldest|name|largest)
GET/api/files/{file_id}/{filename}下载文件,免鉴权,可分享;加 ?inline=1 浏览器内预览
DEL/api/files/{file_id}🔒 删除文件
GET/api/tweets推文列表(q / author / order=timeline|random)
POST/api/tweets🔒 用 JSON 直接导入一条推文(按 tweet_id 幂等)
POST/api/tweets/batch🔒 一次导入 1–500 条推文
GET/api/tweets/authors作者列表(推文数 + 最近归档时间)
POST/api/download🔒 提交推文 URL 抓取(gallery-dl,失败回退镜像接口)
GET/api/jobs/{job_id}轮询抓取任务状态

当前状态

实时读取自 /health、/api/files、/api/tweets。

服务

加载中…

文件

— 个已上传

推文

— 条已归档