记录一下使用宝塔面板部署 webman 、配置 Nginx 代理和 SSL 证书的过程

如有不足，欢迎大家指正、补充、讨论。

第 1 步：在宝塔新建一个站点，填写自己的域名，这时候一般是个空站点，只有默认的文件。

第 2 步：进入站点目录，克隆仓库里面的项目，或者是手动上传项目。

第 3 步：启动 webman 项目。

第 4 步：软件商店 - Nginx - 设置 - 配置修改：

在 nginx 配置文件 http 块中加入：

http {

# 此处省略……

upstream webman {
  server 127.0.0.1:8787;
  keepalive 10240;
}

第 5 步：网站 - 找到站点 - 设置 - 配置文件：

站点配置中 server 块的修改：

# 注意，以下{}部分需替换为真实值！
server
{
    listen 80;

    # 如果开启 SSL 即 HTTPS：
    listen 443 ssl http2;

    server_name {域名};
    index index.php index.html index.htm default.php default.htm default.html;
    # 注意，这里一定是webman下的public目录，不能是webman根目录
    root /www/wwwroot/{项目目录}/public;

    # 如果开启 SSL 即 HTTPS：
    #SSL-START SSL相关配置，请勿删除或修改下一行带注释的404规则

    #error_page 404/404.html;
    ssl_certificate  /www/server/panel/vhost/cert/{域名}/fullchain.pem;
    ssl_certificate_key /www/server/panel/vhost/cert/{域名}/privkey.pem;
    ssl_protocols TLSv1.1 TLSv1.2 TLSv1.3;
    ssl_ciphers EECDH+CHACHA20:EECDH+CHACHA20-draft:EECDH+AES128:RSA+AES128:EECDH+AES256:RSA+AES256:EECDH+3DES:RSA+3DES:!MD5;
    ssl_prefer_server_ciphers on;
    ssl_session_cache shared:SSL:10m;
    ssl_session_timeout 10m;
    add_header Strict-Transport-Security "max-age=31536000";
    error_page 497  https://$host$request_uri;

    #SSL-END

    #ERROR-PAGE-START  错误页配置，可以注释、删除或修改
    #error_page 404 /404.html;
    #error_page 502 /502.html;
    #ERROR-PAGE-END

    #PHP-INFO-START  PHP引用配置，可以注释或修改
    include enable-php-82.conf;
    #PHP-INFO-END

    #REWRITE-START URL重写规则引用,修改后将导致面板设置的伪静态规则失效
    include /www/server/panel/vhost/rewrite/{域名}.conf;
    #REWRITE-END

    # 来自 webman 手册
    location ^~ / {
      proxy_set_header Host $http_host;
      proxy_set_header X-Forwarded-For $remote_addr;
      proxy_set_header X-Forwarded-Proto $scheme;
      proxy_set_header X-Real-IP $remote_addr;
      proxy_http_version 1.1;
      proxy_set_header Connection "";
      if (!-f $request_filename){
          proxy_pass http://webman;
      }
    }

    # 拒绝访问所有以 .php 结尾的文件
    location ~ \.php$ {
        return 404;
    }

    #禁止访问的文件或目录
    location ~ ^/(\.user.ini|\.htaccess|\.git|\.env|\.svn|\.project|LICENSE|README.md)
    {
        return 404;
    }

    #一键申请SSL证书验证目录相关设置
    location ~ \.well-known{
        allow all;
    }

    #禁止在证书验证目录放入敏感文件
    if ( $uri ~ "^/\.well-known/.*\.(php|jsp|py|js|css|lua|ts|go|zip|tar\.gz|rar|7z|sql|bak)$" ) {
        return 403;
    }

    location ~ .*\.(gif|jpg|jpeg|png|bmp|swf)$
    {
        expires      30d;
        error_log /dev/null;
        access_log /dev/null;
    }

    location ~ .*\.(js|css)?$
    {
        expires      12h;
        error_log /dev/null;
        access_log /dev/null;
    }

     # 拒绝访问所有以 . 开头的文件或目录
    location ~ /\. {
        return 404;
    }

    access_log  /www/wwwlogs/api.yulangongwu.online.log;
    error_log  /www/wwwlogs/api.yulangongwu.online.error.log;
}

其中：

listen 443 ssl http2;

#SSL-START SSL相关配置，请勿删除或修改下一行带注释的404规则
#error_page 404/404.html;
ssl_certificate  /www/server/panel/vhost/cert/{域名}/fullchain.pem;
ssl_certificate_key /www/server/panel/vhost/cert/{域名}/privkey.pem;
ssl_protocols TLSv1.1 TLSv1.2 TLSv1.3;
ssl_ciphers EECDH+CHACHA20:EECDH+CHACHA20-draft:EECDH+AES128:RSA+AES128:EECDH+AES256:RSA+AES256:EECDH+3DES:RSA+3DES:!MD5;
ssl_prefer_server_ciphers on;
ssl_session_cache shared:SSL:10m;
ssl_session_timeout 10m;
add_header Strict-Transport-Security "max-age=31536000";
error_page 497  https://$host$request_uri;
#SSL-END

是在宝塔上开启 SSL 才有的。

关于如何开启 SSL ，或者开启 SSL 时出现验证域名失败的问题：

方式 1：手动将证书放到宝塔上，修改 ssl_certificate 和 ssl_certificate_key 的路径，一般没问题。

方式 2：使用宝塔的 Let's Encrypt 申请证书：

此时有可能出现验证域名失败的问题，原因应该是访问项目目录下 .well-known 文件夹中的验证文件时，没有访问到，因为此时已经开启 nginx 代理了，请求转发到 webman 中了，而这是个静态文件。（不知道理解是否正确）

此时可以先停掉 webman 服务，注释掉站点配置中的 nginx 代理代码，此时再申请证书就可以了。

申请完毕后，再恢复以上配置，启动 webman 即可正常使用 HTTPS 访问。