LinuxServer SWAG Docker 镜像使用指南

项目介绍

LinuxServer SWAG Docker 镜像是一个集成了 Nginx 和 Let's Encrypt 的 Docker 容器，旨在为您的网站提供安全的 HTTPS 访问。它支持多种验证方式，包括 HTTP、DNS 和 DuckDNS，适用于不同的域名和证书提供商。SWAG 还提供了灵活的反向代理配置，可以轻松地将多个服务部署在同一域名下。

项目快速启动

使用 Docker CLI 启动 SWAG 容器

docker create \
  --name=swag \
  --cap-add=NET_ADMIN \
  --net=lsio \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Europe/London \
  -e URL=linuxserver-test.com \
  -e SUBDOMAINS=wildcard \
  -e VALIDATION=dns \
  -e DNSPLUGIN=cf \
  -p 443:443 \
  -p 80:80 \
  -v /home/aptalca/appdata/swag:/config \
  --restart unless-stopped \
  linuxserver/swag

使用 Docker Compose 启动 SWAG 容器

version: "2.1"
services:
  swag:
    image: linuxserver/swag
    container_name: swag
    cap_add:
      - NET_ADMIN
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Europe/London
      - URL=linuxserver-test.com
      - SUBDOMAINS=wildcard
      - VALIDATION=dns
      - DNSPLUGIN=cf
    volumes:
      - /home/aptalca/appdata/swag:/config
    ports:
      - 443:443
      - 80:80
    restart: unless-stopped

应用案例和最佳实践

使用 SWAG 作为反向代理

SWAG 可以作为多个服务的反向代理，例如 Plex、Nextcloud 和 Ombi。以下是一个典型的反向代理配置示例：

server {
    listen 443 ssl;
    server_name plex.linuxserver-test.com;
    include /config/nginx/ssl.conf;
    location / {
        proxy_pass http://localhost:32400;
        include /config/nginx/proxy.conf;
    }
}

使用 SWAG 托管静态网站

您可以将 SWAG 用于托管简单的 HTML 网站。只需将您的 HTML 文件放置在 /config/www 目录下，SWAG 会自动提供这些文件。

典型生态项目

Plex

Plex 是一个媒体服务器，可以通过 SWAG 提供的反向代理进行访问。以下是 Plex 的 Docker Compose 配置示例：

version: "2.1"
services:
  plex:
    image: linuxserver/plex
    container_name: plex
    network_mode: host
    environment:
      - PUID=1000
      - PGID=1000
      - VERSION=docker
    volumes:
      - /home/aptalca/appdata/plex:/config
      - /home/aptalca/tvshows:/data/tvshows
      - /home/aptalca/movies:/data/movies
    restart: unless-stopped

Nextcloud

Nextcloud 是一个自托管的文件同步和共享解决方案。以下是 Nextcloud 的 Docker Compose 配置示例：

version: "2.1"
services:
  nextcloud:
    image: linuxserver/nextcloud
    container_name: nextcloud
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Europe/London
    volumes:
      - /home/aptalca/appdata/nextcloud:/config
      - /home/aptalca/data:/data
    ports:
      - 8080:80
    restart: unless-stopped

通过这些配置，您可以轻松地将