42_124/CT124_Picsur操作手冊_20260622.md

CT124 Picsur(自架圖床)— 操作手冊

主機:CT124（192.168.42.124，Ubuntu 24.04 LXC）　|　位置:/opt/picsur 用途:自架圖片上傳/分享(ShareX 相容),產生短網址圖片連結

---

一、基本資訊

• 版本:Picsur 0.5.6（ghcr.io/caramelfur/picsur:latest）+ PostgreSQL 17
• 容器:picsur(:8080)、picsur_postgres(postgres:17-alpine,內網)
• 埠:8080 → 8080
• 對外:NPM 反代 https://picsur.lotimmy.com（已驗證 200）
• 自動更新:picsur 帶 com.centurylinklabs.watchtower.enable=true → Watchtower 會自動拉新版,版號可能自己跳。

二、存取與帳號

• Web:https://picsur.lotimmy.com（內網 http://192.168.42.124:8080）
• 管理員:帳號固定 admin(不可改),密碼在 compose 的 PICSUR_ADMIN_PASSWORD(目前值見 compose / 密碼管理器)。
  • 該密碼僅首次建立帳號時生效;之後請在 UI 改密碼,compose 那行可留作 reset 用途。

三、操作

cd /opt/picsur
docker compose up -d
docker compose ps
docker compose logs -f picsur
docker compose pull && docker compose up -d   # 手動更新(平常 Watchtower 也會自動更)

四、資料與備份

• Postgres 資料:綁定卷 ./postgres-data(→ /var/lib/postgresql/data,目前 ~417M,圖片也存 DB 內)。
• 備份(整個圖床狀態都在這顆 DB):

  # 檔案層(停服務較保險)
  cd /opt/picsur && docker compose stop && tar -czf picsur-data-$(date +%F).tar.gz postgres-data && docker compose start
  # 或邏輯備份
  docker exec picsur_postgres pg_dump -U picsur picsur > picsur-$(date +%F).sql
  

五、ShareX / 上傳設定

• Picsur 內建 ShareX 設定下載:登入後到使用者設定頁取得 .sxcu,或用 API token 上傳。
• API:POST https://picsur.lotimmy.com/api/image/upload(帶 Authorization)。詳見官方:https://github.com/CaramelFur/Picsur

六、注意事項

• 圖片與 metadata 都存在 PostgreSQL,備份只認 postgres-data(或 pg_dump),別只備 compose。
• 對外 443 經 NPM → 依賴 docker daemon 與 NPM 容器(見 CT124_故障復原_20260529.md)。
• Watchtower 自動更新雖方便,但 :latest 偶有 breaking change;重要資料記得先有近期備份。