Core HTTP 服务

先通过 CLI 配置上传目标，再启动 picgo-server。Core 服务提供上传与心跳接口，不包含桌面相册管理及桌面删除接口。

启动服务

picgo-server --host 127.0.0.1 --port 36677 -c /path/to/data.json

参数	用途
-c, --config	JSON 配置文件
-p, --port	端口，默认 36677
--host	监听地址，默认 0.0.0.0
-k, --key	远程上传密钥

仅本机集成时明确绑定 127.0.0.1。服务会跳过回环请求的密钥校验。远程访问需要设置自己的密钥，并通过受控网络或 HTTPS 反向代理连接。

上传文件

curl -X POST "http://127.0.0.1:36677/upload" \
  -F "file=@./image.png"

multipart/form-data 传入的是文件内容，适合远程客户端。可以使用多个文件字段上传多张图片。

上传路径或 URL

curl -X POST "http://127.0.0.1:36677/upload" \
  -H "Content-Type: application/json" \
  -d '{"list":["/absolute/path/image.png","https://example.com/photo.jpg"]}'

路径必须在服务所在机器或容器中可访问。省略文件列表会尝试剪贴板上传，不适合无桌面服务器。

选择图床与配置

curl -X POST "http://127.0.0.1:36677/upload?picbed=aws-s3-plist&configName=Docs" \
  -F "file=@./image.png"

图床使用程序 ID，配置名需要与保存值一致。远程请求将你自行设置的密钥作为 key 查询参数传入；不要在共享的示例、截图和日志中保留它。

响应

{"success":true,"result":["https://images.example.com/image.png"]}

请同时检查 success 与结果列表。Core 成功响应返回 URL；不要假设它含有桌面版的 fullResult 或删除信息。

心跳与接口文档

curl http://127.0.0.1:36677/heartbeat

心跳成功返回 {"success":true,"result":"alive"}。在浏览器打开服务根路径可查看接口示例。