feat(outlook): 添加 Outlook MCP 集成支持并优化分页功能
- 新增 NANO_OUTLOOK_MCP_URL 和 NANO_OUTLOOK_MCP_SERVER_ID 环境变量配置 - 实现 Outlook 邮件和日历的分页查询功能,添加安全参数验证 - 为 app-instance 创建脚本添加 Outlook MCP 服务器 ID 参数 - 更新前端 Outlook 页面实现邮件列表和日历事件的分页浏览 - 添加 Git 忽略文件配置和 Docker 挂载路径修复 BREAKING CHANGE: Outlook 集成现在需要配置 MCP URL 和服务器 ID 环境变量
This commit is contained in:
395
域名配置指引.md
Normal file
395
域名配置指引.md
Normal file
@ -0,0 +1,395 @@
|
||||
# nano_project 域名配置指引
|
||||
|
||||
这份文档专门解释一件事:
|
||||
|
||||
- 如果你不用 `127.0.0.1.nip.io`
|
||||
- 想换成自己的正式域名
|
||||
- 应该怎么理解、怎么配、该改哪些地方
|
||||
|
||||
先说最重要的结论:
|
||||
|
||||
- `DNS` 只管把域名解析到 `IP`
|
||||
- `端口` 不归 DNS 管
|
||||
- 所以“域名配到哪个端口”本质上是反向代理或公网入口层在处理
|
||||
|
||||
也就是说:
|
||||
|
||||
- 域名解析本身,是项目外部的事情
|
||||
- 但项目里生成出来的实例地址、门户地址,又会依赖你填的域名
|
||||
|
||||
所以这件事是:
|
||||
|
||||
- 一半在系统外
|
||||
- 一半和系统配置有关
|
||||
|
||||
---
|
||||
|
||||
## 1. 先理解这套系统里每个端口是干什么的
|
||||
|
||||
当前默认端口职责:
|
||||
|
||||
- `3081`
|
||||
- `auth-portal`
|
||||
- 用户注册、登录入口
|
||||
- `8088`
|
||||
- `router-proxy`
|
||||
- 所有用户实例统一入口
|
||||
- `8090`
|
||||
- `deploy-control`
|
||||
- 内部控制面
|
||||
- `19090`
|
||||
- `authz-service`
|
||||
- 内部鉴权服务
|
||||
|
||||
正常公网暴露建议:
|
||||
|
||||
- 暴露 `3081`
|
||||
- 暴露 `8088`
|
||||
- 不要直接暴露 `8090`
|
||||
- 不要直接暴露 `19090`
|
||||
|
||||
---
|
||||
|
||||
## 2. 推荐的域名规划
|
||||
|
||||
最推荐这样分:
|
||||
|
||||
- `portal.example.com`
|
||||
- 给登录/注册页
|
||||
- `*.apps.example.com`
|
||||
- 给用户实例
|
||||
|
||||
这样用户最终访问会像:
|
||||
|
||||
```text
|
||||
https://portal.example.com
|
||||
https://alice.apps.example.com
|
||||
https://bob.apps.example.com
|
||||
```
|
||||
|
||||
其中:
|
||||
|
||||
- `portal.example.com` 走 `auth-portal`
|
||||
- `alice.apps.example.com` 走 `router-proxy`
|
||||
|
||||
---
|
||||
|
||||
## 3. 只配 DNS 还不够
|
||||
|
||||
很多人最容易误解的是:
|
||||
|
||||
“我把域名解析到服务器 IP,就等于已经配好了”
|
||||
|
||||
这不对。
|
||||
|
||||
你还要解决:
|
||||
|
||||
- 用户访问 `80/443` 时,流量先进谁
|
||||
- 谁把流量转到 `3081`
|
||||
- 谁把流量转到 `8088`
|
||||
|
||||
所以正式域名一般至少要有两层:
|
||||
|
||||
### 第一层:DNS
|
||||
|
||||
例如:
|
||||
|
||||
- `portal.example.com` -> 服务器公网 IP
|
||||
- `apps.example.com` -> 服务器公网 IP
|
||||
- `*.apps.example.com` -> 服务器公网 IP
|
||||
|
||||
### 第二层:公网反向代理
|
||||
|
||||
例如用:
|
||||
|
||||
- Nginx
|
||||
- Caddy
|
||||
- Traefik
|
||||
- 云负载均衡
|
||||
|
||||
它负责:
|
||||
|
||||
- 监听公网 `80/443`
|
||||
- 根据域名把请求转发到本机不同端口
|
||||
|
||||
---
|
||||
|
||||
## 4. 最直接的映射关系
|
||||
|
||||
如果你先不做 HTTPS,只做最基础的 HTTP:
|
||||
|
||||
- `portal.example.com` -> 转发到 `127.0.0.1:3081`
|
||||
- `*.apps.example.com` -> 转发到 `127.0.0.1:8088`
|
||||
|
||||
也就是:
|
||||
|
||||
```text
|
||||
portal.example.com -> auth-portal -> 3081
|
||||
*.apps.example.com -> router-proxy -> 8088
|
||||
```
|
||||
|
||||
注意:
|
||||
|
||||
- `router-proxy` 是靠 `Host` 头识别具体实例的
|
||||
- 所以必须把原始 Host 透传过去
|
||||
|
||||
---
|
||||
|
||||
## 5. 这个项目内部哪些值要改
|
||||
|
||||
如果你要从 `127.0.0.1.nip.io` 换成正式域名,至少要改这些:
|
||||
|
||||
### 本机部署变量里
|
||||
|
||||
把:
|
||||
|
||||
```bash
|
||||
export NANO_BASE_DOMAIN=127.0.0.1.nip.io
|
||||
```
|
||||
|
||||
改成:
|
||||
|
||||
```bash
|
||||
export NANO_BASE_DOMAIN=apps.example.com
|
||||
```
|
||||
|
||||
这样以后新创建的实例 URL 才会变成:
|
||||
|
||||
```text
|
||||
http://alice.apps.example.com:8088
|
||||
```
|
||||
|
||||
如果你后面还有外层 `80/443` 代理,不想让用户看到 `:8088`,那还需要额外调整入口层做无端口访问转发。
|
||||
|
||||
### `deploy-control` 里实际影响实例地址的变量
|
||||
|
||||
它们是:
|
||||
|
||||
- `DEPLOY_PUBLIC_SCHEME`
|
||||
- `DEPLOY_PUBLIC_BASE_DOMAIN`
|
||||
- `DEPLOY_PUBLIC_PORT`
|
||||
|
||||
例如:
|
||||
|
||||
```bash
|
||||
-e DEPLOY_PUBLIC_SCHEME="https" \
|
||||
-e DEPLOY_PUBLIC_BASE_DOMAIN="apps.example.com" \
|
||||
-e DEPLOY_PUBLIC_PORT="443" \
|
||||
```
|
||||
|
||||
或者如果你暂时还是明文 HTTP:
|
||||
|
||||
```bash
|
||||
-e DEPLOY_PUBLIC_SCHEME="http" \
|
||||
-e DEPLOY_PUBLIC_BASE_DOMAIN="apps.example.com" \
|
||||
-e DEPLOY_PUBLIC_PORT="8088" \
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 6. 什么时候可以把端口从 URL 里去掉
|
||||
|
||||
如果你希望用户访问:
|
||||
|
||||
```text
|
||||
https://alice.apps.example.com
|
||||
```
|
||||
|
||||
而不是:
|
||||
|
||||
```text
|
||||
http://alice.apps.example.com:8088
|
||||
```
|
||||
|
||||
那你需要满足这两个条件:
|
||||
|
||||
1. 外层已经有监听 `80/443` 的反向代理
|
||||
2. 它已经把 `*.apps.example.com` 转发到本机 `8088`
|
||||
|
||||
这时项目内部就应该写:
|
||||
|
||||
```bash
|
||||
DEPLOY_PUBLIC_SCHEME=https
|
||||
DEPLOY_PUBLIC_BASE_DOMAIN=apps.example.com
|
||||
DEPLOY_PUBLIC_PORT=443
|
||||
```
|
||||
|
||||
或者很多时候你也可以直接在显示层隐藏默认端口概念,让用户只看标准 `https` 地址。
|
||||
|
||||
---
|
||||
|
||||
## 7. 一套推荐的正式域名方案
|
||||
|
||||
假设你有:
|
||||
|
||||
- 门户域名:`portal.example.com`
|
||||
- 实例根域名:`apps.example.com`
|
||||
|
||||
推荐这样做:
|
||||
|
||||
### 项目内部
|
||||
|
||||
`deploy-control`:
|
||||
|
||||
```bash
|
||||
-e DEPLOY_PUBLIC_SCHEME="https" \
|
||||
-e DEPLOY_PUBLIC_BASE_DOMAIN="apps.example.com" \
|
||||
-e DEPLOY_PUBLIC_PORT="443" \
|
||||
```
|
||||
|
||||
本机部署变量:
|
||||
|
||||
```bash
|
||||
export NANO_BASE_DOMAIN=apps.example.com
|
||||
```
|
||||
|
||||
### 项目外部
|
||||
|
||||
DNS:
|
||||
|
||||
- `portal.example.com` -> 服务器 IP
|
||||
- `apps.example.com` -> 服务器 IP
|
||||
- `*.apps.example.com` -> 服务器 IP
|
||||
|
||||
公网代理:
|
||||
|
||||
- `portal.example.com` -> `127.0.0.1:3081`
|
||||
- `*.apps.example.com` -> `127.0.0.1:8088`
|
||||
|
||||
---
|
||||
|
||||
## 8. 一个常见误区
|
||||
|
||||
### 误区 1
|
||||
|
||||
“我把 `portal.example.com` 配给 `8088` 可以吗?”
|
||||
|
||||
技术上能转,但不推荐。
|
||||
|
||||
因为:
|
||||
|
||||
- `8088` 是实例入口
|
||||
- `3081` 才是门户入口
|
||||
|
||||
更清晰的职责划分应该是:
|
||||
|
||||
- 门户 -> `3081`
|
||||
- 实例 -> `8088`
|
||||
|
||||
### 误区 2
|
||||
|
||||
“我能不能把 `8090` 和 `19090` 也直接开放给公网?”
|
||||
|
||||
不建议。
|
||||
|
||||
因为:
|
||||
|
||||
- `8090` 是内部部署控制面
|
||||
- `19090` 是内部鉴权服务
|
||||
|
||||
这两个应该尽量只允许容器网络或内网访问。
|
||||
|
||||
### 误区 3
|
||||
|
||||
“DNS 能不能直接决定端口?”
|
||||
|
||||
不能。
|
||||
|
||||
DNS 只能决定:
|
||||
|
||||
- 域名 -> IP
|
||||
|
||||
端口是:
|
||||
|
||||
- 浏览器默认端口规则
|
||||
- URL 里显式写端口
|
||||
- 反向代理转发规则
|
||||
|
||||
共同决定的。
|
||||
|
||||
---
|
||||
|
||||
## 9. 最简单的理解方式
|
||||
|
||||
把它拆成两件事就不容易乱:
|
||||
|
||||
### 系统内的事
|
||||
|
||||
这个项目要知道:
|
||||
|
||||
- 实例公网地址长什么样
|
||||
- 新实例生成什么域名
|
||||
- 对外协议是 `http` 还是 `https`
|
||||
|
||||
所以它关心:
|
||||
|
||||
- `DEPLOY_PUBLIC_SCHEME`
|
||||
- `DEPLOY_PUBLIC_BASE_DOMAIN`
|
||||
- `DEPLOY_PUBLIC_PORT`
|
||||
|
||||
### 系统外的事
|
||||
|
||||
你的服务器或云环境要负责:
|
||||
|
||||
- 域名解析
|
||||
- TLS 证书
|
||||
- 80/443 入口
|
||||
- 把请求转给 `3081` 或 `8088`
|
||||
|
||||
---
|
||||
|
||||
## 10. 如果你现在只是本机测试
|
||||
|
||||
那你可以完全先不管正式域名。
|
||||
|
||||
继续用:
|
||||
|
||||
```bash
|
||||
export NANO_BASE_DOMAIN=127.0.0.1.nip.io
|
||||
```
|
||||
|
||||
这已经足够验证整个系统:
|
||||
|
||||
- 注册
|
||||
- 登录
|
||||
- 创建实例
|
||||
- 跳转个人实例
|
||||
|
||||
等你准备真正对外给别人访问时,再处理正式域名和 HTTPS。
|
||||
|
||||
---
|
||||
|
||||
## 11. 一句话结论
|
||||
|
||||
如果你问:
|
||||
|
||||
“域名应该配到什么端口上?”
|
||||
|
||||
最实用的答案是:
|
||||
|
||||
- 门户域名 -> `3081`
|
||||
- 实例泛域名 -> `8088`
|
||||
- `8090` 和 `19090` 不建议直接公开
|
||||
|
||||
但更准确地说:
|
||||
|
||||
- 域名解析本身不带端口
|
||||
- 真正的端口转发,是由外层反向代理做的
|
||||
|
||||
---
|
||||
|
||||
## 12. 你后面最可能要补的东西
|
||||
|
||||
如果你准备上正式域名,下一步通常是补下面其中一个:
|
||||
|
||||
- `Nginx` 反向代理配置
|
||||
- `Caddy` 配置
|
||||
- 云负载均衡转发规则
|
||||
- HTTPS 证书配置
|
||||
|
||||
如果你要,我下一步可以继续给你补:
|
||||
|
||||
- `Nginx 域名反代示例.md`
|
||||
- 或者 `Caddy 域名反代示例.md`
|
||||
|
||||
都可以直接按这个项目的端口结构来写。
|
||||
Reference in New Issue
Block a user