Nginx文档

nginx常用命令

命令	说明
sudo apt update && sudo apt install -yq nginx	安装 Nginx
sudo systemctl start nginx	启动 Nginx
sudo systemctl stop nginx	停止 Nginx
sudo systemctl restart nginx	重启 Nginx
sudo nginx -t	检查 Nginx 配置
sudo journalctl -u nginx	查看 Nginx 日志
sudo systemctl reload nginx	重新加载 Nginx 配置
sudo systemctl status nginx	查看 Nginx 状态
sudo systemctl enable nginx	启用 Nginx 开机自启动
sudo systemctl disable nginx	禁用 Nginx 开机自启动
sudo apt purge nginx	完全卸载 Ngxin

配置文件路径	说明
/etc/nginx/nginx.conf	主配置文件
/etc/nginx/sites-available/	站点配置文件目录
/etc/nginx/sites-enabled/	启用的站点配置文件目录
tail -f /var/log/nginx/access.log	查看访问日志
tail -f /var/log/nginx/error.log	查看错误日志
/etc/nginx/conf.d/	自定义配置文件目录
Nginx 配置生成器	在线生成 Nginx 配置

---

Caddy文档

caddy模块查询文档

Docker部署

docker-compose.yaml配置

services:
  caddy:
    image: caddy:alpine
    container_name: caddy
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile    # 映射配置文件
      - ./web:/srv                           # 映射站点目录
    restart: always

---

apt安装caddy命令

sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https curl
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | sudo tee /etc/apt/sources.list.d/caddy-stable.list
sudo apt update
sudo apt install caddy -yq

一键安装：

sudo apt install -yq debian-keyring debian-archive-keyring apt-transport-https curl && curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg && curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | sudo tee /etc/apt/sources.list.d/caddy-stable.list && sudo apt update -q && sudo apt install -yq caddy

命令或路径	说明
sudo systemctl restart caddy	启动或重启 Caddy
sudo systemctl status caddy	查看 Caddy 运行状态
sudo journalctl -u caddy	查看 Caddy 日志
caddy validate --config /etc/caddy/Caddyfile	检查 Caddy 配置文件
sudo systemctl stop caddy	停止 Caddy 服务
sudo apt-get purge --auto-remove caddy	完全卸载 Caddy
/etc/caddy/Caddyfile	Caddy 配置文件路径

Caddy 证书存储路径 /var/lib/caddy/.local/share/caddy/certificates/acme-v02.api.letsencrypt.org-directory

反向代理示例

example.com {
    encode zstd gzip
    reverse_proxy 127.0.0.1:8080
}

反代Docker并获取访客真实IP

example.com {
    reverse_proxy {
        to 127.0.0.1:8080
        header_up X-Real-IP {remote}
        header_up X-Forwarded-For {remote}
        header_up X-Forwarded-Proto {scheme}
    }
}

cloudflare CDN：

example.com {
    reverse_proxy 127.0.0.1:8080 {
        header_up X-Forwarded-For {http.request.header.CF-Connecting-IP}
        header_up X-Real-IP {http.request.header.CF-Connecting-IP}
        header_up X-Forwarded-Proto https
        header_up X-Forwarded-Host {host}
    }
}

代理站点目录示例

example.com {
    root * /var/www
    encode zstd gzip
    file_server
}

---

内网自签证书

domain.com {
    reverse_proxy 127.0.0.1:8080  # 反代本地服务
    tls internal  # 自签证书
}

CA证书默认存储在Caddy的数据目录中，通常可以在以下路径找到：

Linux/macOS: ~/.local/share/caddy

Windows: C:\Users\<YourUser>\AppData\Roaming\Caddy

可以将 pki/authorities/local/root.crt 文件复制到客户端设备并安装到受信任的证书存储中。

Docker部署的证书文件在容器内的/data目录

---

win系统运行

下载caddy对应的win版本

将Caddyfile和caddy.exe放在同一个目录下，然后在这个路径下执行caddy.exe run运行

win系统放行端口

Win + R打开运行窗口，输入control回车，打开控制面板。

控制面板 > 系统和安全 > Windows Defender 防火墙 > 高级设置 > 左侧入站规则 > 右侧新建规则 > 端口 > 下一步

然后就可以放行端口了，放行出站规则同理。

使用任务调度器后台运行Caddy

1. 创建任务

管理员打开cmd命令窗口

schtasks /create /tn "Caddy" /tr "C:\Caddy\caddy.exe run" /sc onstart /ru "SYSTEM"

注意修改C:\Caddy\caddy.exe这个实际路径

2. 查看任务

schtasks /query /tn "Caddy"

3. 启动任务

schtasks /run /tn "Caddy"

4. 删除任务

schtasks /delete /tn "Caddy" /f

5. 关闭caddy进程

taskkill /F /IM caddy.exe