Help Needed: Trouble Accessing Postiz via HTTPS on Synology DS220+

[s0536587-htw]

Hi everyone,

I'm fairly new to this space and recently tried setting up Postiz on my Synology DS220+ using Portainer. The initial setup went smoothly, and the service is running fine when accessed via a local .lan domain.

However, I'm facing a big issue: I can’t access Postiz using my public domain https://postiz.my-server.synology.me, which makes integrating it with platforms like YouTube impossible.

What's strange is that I’ve deployed other containers like n8n the same way, and they work perfectly through the same domain setup. So I’m stuck here and not sure what I’m missing.

Has anyone dealt with a similar problem or maybe has an idea on what could be going wrong? I’d really appreciate any tips, suggestions, or shared experiences.

Thanks in advance!

[dragon375014]

You can copy &paste to your ai agent.

七、外網存取（Tailscale Funnel）

如果你需要串接 Facebook/Instagram，Meta OAuth 強制要求 HTTPS 公網網域。

為什麼選 Tailscale Funnel？

方案	優點	缺點
Tailscale Funnel	最簡單、免費、自動 SSL	只能用 .ts.net 子域
Cloudflare Tunnel	可用自訂網域	需要額外安裝 cloudflared
Synology DDNS + 反向代理	內建功能	需要設定路由器 port forwarding

設定步驟

1. 在 NAS 安裝 Tailscale（如果還沒有）

透過 Synology 套件中心或 SSH 安裝。

2. 啟用 Funnel

先到 Tailscale Admin Console：

• 啟用 HTTPS Certificates
• 啟用 Funnel

3. 在 NAS 上啟動 Funnel

sudo tailscale funnel --bg 5123

輸出會顯示你的公網 URL：

Available on the internet:
https://你的機器名.tail*****.ts.net/
|-- proxy http://127.0.0.1:5123

4. 更新 Postiz 環境變數

修改 docker-compose.yml 中的 URL 為你的 Tailscale 域名：

MAIN_URL: "https://你的機器名.tail*****.ts.net"
FRONTEND_URL: "https://你的機器名.tail*****.ts.net"
NEXT_PUBLIC_BACKEND_URL: "https://你的機器名.tail*****.ts.net/api"

重要： NOT_SECURED: "true" 即使在 HTTPS 環境下也要保留！Postiz 的登入流程依賴這個變數，移除後會導致登入按鈕無反應。

5. 重啟

cd /volume1/docker/postiz
sudo docker compose down && sudo docker compose up -d

6. 驗證

開瀏覽器前往 https://你的機器名.tail*****.ts.net，確認能登入。

---

八、踩坑避坑總整理

坑 1：登入按鈕無反應（原地不動）

症狀： 點 Sign In 沒有任何錯誤，頁面完全不動。

原因： Postiz 預設使用 Secure Cookie，HTTP 環境下瀏覽器直接拒絕儲存。

解法： 環境變數加上 NOT_SECURED: "true"。

重要補充： 即使後來掛上 HTTPS（如 Tailscale Funnel），NOT_SECURED: "true" 仍然需要保留。實測移除後登入又會失效。

---

坑 2：CORS 跨域錯誤

症狀： Console 顯示 Access-Control-Allow-Headers 相關錯誤。

原因： 前端（port 4200）和後端（port 3000）不同 port = 不同 origin。

解法： 用 nginx 反向代理統一到一個 port（如 5123），前後端走同一個 origin。

錯誤做法： 直接暴露 3000 + 4200 兩個 port 讓瀏覽器分別存取。

---

坑 3：ERR_EMPTY_RESPONSE（註冊時）

症狀： 註冊 API 回傳空回應，但帳號已建立在 DB。

原因： Postiz 嘗試發驗證信，但沒有設定 SMTP → 後端拋出未處理的例外。

解法： 加上 DISABLE_REGISTRATION_VERIFICATION: "true" 和 EMAIL_PROVIDER: "local"。

---

坑 4：密碼 hash 的 $ 符號被 bash 吃掉

症狀： 用 SQL 更新密碼後，登入顯示「Invalid password」。

原因： bcrypt hash 如 $2b$10$xq7q... 在 bash 雙引號中，$2b、$10 會被解析為空變數。

解法： 用 heredoc + 單引號：

sudo docker exec -i postiz-db psql -U postiz -d postiz << 'ENDSQL'
UPDATE "User" SET password = '$2b$10$完整hash' WHERE email = '你的email';
ENDSQL

---

坑 5：Temporal 連線失敗

症狀： ECONNREFUSED 127.0.0.1:7233 或 [::1]:7233。

原因： Postiz 的 docker-compose 缺少 Temporal 服務，或容器名稱不匹配。

解法：

1. 加入 temporalio/auto-setup 容器 + 獨立的 PostgreSQL
2. 環境變數設定 TEMPORAL_ADDRESS: "postiz-temporal:7233"（必須跟容器名稱一致）
3. 確保 depends_on 順序正確：temporal-db → temporal → postiz

---

坑 6：users 表不存在

症狀： ERROR: relation "users" does not exist

原因： Postiz 的表名是 "User"（大寫 U），不是 users。PostgreSQL 大小寫敏感，大寫表名必須加雙引號。

解法： SQL 中用 "User"：

SELECT * FROM "User" WHERE email = '...';

---

坑 7：Bind mount 目錄不存在

症狀： Bind mount failed: '/volume1/docker/postiz/xxx' does not exist

原因： Docker volume 掛載的目錄必須事先存在。

解法： 啟動前先建立所有目錄：

sudo mkdir -p /volume1/docker/postiz/{postgres-data,temporal-postgres-data,uploads,nginx}

---

坑 8：Permission denied 寫入檔案

症狀： cat > docker-compose.yml 報 Permission denied。

原因： NAS 上的 /volume1/docker/ 目錄需要 root 權限。

解法： 用 sudo tee 取代 cat >：

sudo tee /volume1/docker/postiz/docker-compose.yml > /dev/null << 'COMPOSE'
# 內容...
COMPOSE

---

坑 9：Synology Container Manager UI 的變數解析問題

建議： 不要用群暉內建的 Container Manager UI 來設定 Postiz。直接 SSH 進去用 docker compose 指令，穩定許多。特別是 DATABASE_URL 裡的特殊符號和 JWT_SECRET 長字串，UI 偶爾會解析錯誤。