STEP1. 系統前提 #

• Ubuntu 24.04
• Docker, Docker Compose
• 網域(例:test.bestnetllc.co.jp)
• Let’s Encrypt SSL 憑證

STEP2. OS 和 Docker 的安裝 #

OS 的更新 #

sudo apt-get update
sudo apt-get upgrade -y
sudo apt-get autoremove -y
sudo apt-get autoclean
sudo reboot

Docker 和 Docker Compose 安裝 #

sudo apt-get update
sudo apt-get install -y 
  ca-certificates 
  curl 
  gnupg 
  lsb-release

curl -fsSL https://download.docker.com/linux/ubuntu/gpg 
  | sudo gpg --dearmor -o /usr/share/keyrings/docker.gpg

echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker.gpg] 
  
 
  $(lsb_release -cs) stable" 
  | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

sudo apt-get update
sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

docker --version
docker compose version

STEP3. SSL 憑證的初次發行 #

建立儲存目錄 #

sudo mkdir -p /opt/certs/letsencrypt

暫時停止 Nginx,並發行憑證 #

sudo docker run -it --rm 
  -p 80:80 
  -v /opt/certs/letsencrypt:/etc/letsencrypt 
  certbot/certbot certonly --standalone 
  -d test.bestnetllc.co.jp 
  -m test@bestnetllc.co.jp 
  --agree-tos 
  --no-eff-email

確認成功:

ls /opt/certs/letsencrypt/live/test.bestnetllc.co.jp

STEP4. Dify 的安裝與設定 #

取得儲存庫 #

cd /home
mkdir dify && cd dify
git clone https://github.com/langgenius/dify.git
cd dify/docker

.env 的設定 #

nano .env

環境變數範例:

CERTBOT_EMAIL=test@bestnetllc.co.jp
CERTBOT_DOMAIN=test.bestnetllc.co.jp

NGINX_HTTPS_ENABLED=true
NGINX_SSL_PROTOCOLS="TLSv1.2 TLSv1.3"
NGINX_SSL_CERT_FILENAME=live/test.bestnetllc.co.jp/fullchain.pem
NGINX_SSL_CERT_KEY_FILENAME=live/test.bestnetllc.co.jp/privkey.pem

docker-compose.yaml 的 Nginx 設定範例 #

services:
  nginx:
    image: nginx:latest
    restart: always
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - type: bind
        source: /opt/certs/letsencrypt
        target: /etc/letsencrypt
        read_only: true
      - ./nginx/nginx.conf.template:/etc/nginx/nginx.conf.template
      - ./nginx/conf.d:/etc/nginx/conf.d
    environment:
      NGINX_HTTPS_ENABLED: "true"
      NGINX_SSL_CERT_FILENAME: "live/test.bestnetllc.co.jp/fullchain.pem"
      NGINX_SSL_CERT_KEY_FILENAME: "live/test.bestnetllc.co.jp/privkey.pem"
      NGINX_SSL_PROTOCOLS: "TLSv1.2 TLSv1.3"

啟動與運作確認 #

docker compose up -d
docker compose logs -f nginx

使用瀏覽器存取 https://test.bestnetllc.co.jp

STEP5. SSL 憑證的自動更新設定 #

建立更新指令碼 #

sudo nano /opt/certs/renew_cert.sh

指令碼內容:

#!/bin/bash

cd /home/dify/docker
docker compose stop nginx

docker run --rm 
  -p 80:80 
  -v /opt/certs/letsencrypt:/etc/letsencrypt 
  certbot/certbot renew --standalone

docker compose start nginx

sudo chmod +x /opt/certs/renew_cert.sh

cron 作業設定 #

sudo crontab -e

新增以下內容(每週日凌晨 3 點):

0 3 * * 0 /opt/certs/renew_cert.sh >> /var/log/letsencrypt_renew.log 2>&1

運作測試 #

sudo /opt/certs/renew_cert.sh

STEP6. 故障排除 #

發生問題時請確認記錄檔:

docker compose logs api -f
docker compose logs worker -f
docker compose logs web -f
docker compose logs nginx -f

Internal Server