STEP1. 系统前提 #

• Ubuntu 24.04
• Docker, Docker Compose
• 域名(例: test.bestnetllc.co.jp)
• Let’s Encrypt SSL证书

STEP2. 操作系统和Docker的安装 #

操作系统更新 #

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