From bcba077fdff802a54b7c4f2c2512d0b585131345 Mon Sep 17 00:00:00 2001 From: Timmy Date: Mon, 22 Jun 2026 22:19:19 +0800 Subject: [PATCH] =?UTF-8?q?=E6=96=B0=E5=A2=9E=20CT124=20Picsur=20=E6=93=8D?= =?UTF-8?q?=E4=BD=9C=E6=89=8B=E5=86=8A?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 圖床操作/ShareX/備份;DB 綁定卷 postgres-data,Watchtower 自動更新。 Co-Authored-By: Claude Opus 4.8 (1M context) --- CT124_Picsur操作手冊_20260622.md | 52 ++++++++++++++++++++++++++++++++ README.md | 1 + 2 files changed, 53 insertions(+) create mode 100644 CT124_Picsur操作手冊_20260622.md diff --git a/CT124_Picsur操作手冊_20260622.md b/CT124_Picsur操作手冊_20260622.md new file mode 100644 index 0000000..ef3876a --- /dev/null +++ b/CT124_Picsur操作手冊_20260622.md @@ -0,0 +1,52 @@ +# 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;重要資料記得先有近期備份。 diff --git a/README.md b/README.md index bc8d38c..fe67579 100644 --- a/README.md +++ b/README.md @@ -18,3 +18,4 @@ Claude Code 工作規範見 [`CLAUDE.md`](CLAUDE.md)。 | [CT124_PocketBase操作手冊_20260622.md](CT124_PocketBase操作手冊_20260622.md) | CT124 | 自架 PocketBase(systemd,`:18090` / `pb.lotimmy.com`)服務操作、collections、升級、備份 | | [CT124_NocoDB操作手冊_20260622.md](CT124_NocoDB操作手冊_20260622.md) | CT124 | 自架 NocoDB(`:28080` / `noco.timmy.edu.kg`)操作、API、備份;附 DB 對外與弱帳密提醒 | | [CT124_Redash操作手冊_20260622.md](CT124_Redash操作手冊_20260622.md) | CT124 | 自架 Redash 10.1.0(6 容器,`:5001`,僅 LAN)操作;附 DB 在匿名 volume 的備份風險 | +| [CT124_Picsur操作手冊_20260622.md](CT124_Picsur操作手冊_20260622.md) | CT124 | 自架 Picsur 0.5.6 圖床(`:8080` / `picsur.lotimmy.com`)操作、ShareX、備份;Watchtower 自動更新 |