# 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 用途。

## 三、操作

```bash
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):
  ```bash
  # 檔案層(停服務較保險)
  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`](CT124_故障復原_20260529.md))。
- Watchtower 自動更新雖方便,但 `:latest` 偶有 breaking change;重要資料記得先有近期備份。