xuans/Scert
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

修正文档中的服务端口约定

Browse Source
This commit is contained in:
xuans 2026-08-30 20:50:39 +08:00
parent 6e0308e1a6
commit b08339864a
2 changed files with 9 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
backend/README.md
View File

@ -36,11 +36,11 @@ go run ./cmd/scert serve --base-dir C:\ScertData
当前 `serve` 已接入配置加载、数据库迁移、认证、DNS 在线测试、ACME 证书申请、自动续期、证书导入、SSH 部署和通知流程。HTTPS 生产切换、真实 DNS/ACME 申请、远程服务器及平台安装仍需授权环境验收。
### 开发阶段使用 9003 端口
### 开发阶段使用 9004 与 9003 端口
反向代理开发测试时，将配置中的服务地址设为 `127.0.0.1`、端口设为 `9003`，并将 `https_mode` 设为 `proxy`。Scert 只提供本机内部 HTTPS，公网 HTTPS 由 Nginx 监听 `443` 并转发到 `https://127.0.0.1:9003`。端口可通过配置文件 `server.port` 或初始化参数 `--server-port` 修改；修改后需要重启服务。
反向代理开发测试时，Scert 使用 `127.0.0.1:9004` 提供本机内部 HTTPS，Nginx 使用 `9003` 接收测试访问并转发到 Scert。配置中的 `https_mode` 设为 `proxy`。公网 HTTPS 仍由 Nginx 终止；端口可通过配置文件 `server.port` 或初始化参数 `--server-port` 修改，修改后需要重启服务。
SMTP 通知是 Scert 的出站连接，不需要为 Scert 开放 SMTP 入站端口。公网防火墙通常只需放行 Nginx 使用的 `443`，若配置 HTTP 跳转再放行 `80`；内部端口 `9003` 不应对公网开放。
SMTP 通知是 Scert 的出站连接，不需要为 Scert 开放 SMTP 入站端口。公网防火墙通常只需放行 Nginx 使用的 `443`，若配置 HTTP 跳转再放行 `80`；内部端口 `9004` 和 Nginx 测试端口 `9003` 都不应对公网开放。
## 测试和构建

12
deploy/README.md
View File

@ -76,13 +76,13 @@ Linux 安装目录当前固定为 `/scert`。自定义证书根目录必须是
## 开发阶段反向代理部署
开发阶段可以使用测试域名 `web.xuans.com` 验证 Web 页面和反向代理链路。推荐让 Scert 只监听本机端口 `9003`，由 Nginx 对外提供 HTTPS：
开发阶段可以使用测试域名 `web.xuans.com` 验证 Web 页面和反向代理链路。推荐让 Scert 只监听本机端口 `9004`，由 Nginx 监听 `9003` 接收测试访问并转发：
```text
公网 HTTPS 443
测试访问 HTTPS 9003
↓
Nginx
↓ https://127.0.0.1:9003
↓ https://127.0.0.1:9004
Scert
```
@ -92,7 +92,7 @@ Scert
{
"server": {
"host": "127.0.0.1",
"port": 9003,
"port": 9004,
"https_mode": "proxy"
}
}
@ -109,7 +109,7 @@ server {
ssl_certificate_key /etc/letsencrypt/live/web.xuans.com/privkey.pem;
location / {
proxy_pass https://127.0.0.1:9003;
proxy_pass https://127.0.0.1:9004;
proxy_ssl_server_name on;
proxy_ssl_name web.xuans.com;
proxy_ssl_verify off;
@ -122,7 +122,7 @@ server {
}
```
如果需要 HTTP 自动跳转，再配置并开放 `80`；正常访问只需开放公网 `443`。`9003` 仅供本机 Nginx 使用，不应加入公网防火墙规则。端口可以在配置文件的 `server.port` 修改，修改后需要重启 Scert；如果改为直接对外监听，则还需要同步调整防火墙和安全组规则。
如果需要 HTTP 自动跳转，再配置并开放 `80`；正式公网访问通常使用 `443`，开发测试访问使用 Nginx 的 `9003`。Scert 内部端口 `9004` 和 Nginx 测试端口 `9003` 都不应加入公网防火墙规则。端口可以在配置文件的 `server.port` 修改，修改后需要重启 Scert；如果改为直接对外监听，则还需要同步调整防火墙和安全组规则。
`web.xuans.com` 仅用于开发阶段测试，不能作为生产环境证书、DNS、ACME 或最终 HTTPS 验收依据。