# 前置工作

- 购买云服务器
- 购买域名
- 部署1panel
- 安装OpenResty


![image.png](https://cos.haowee.cn/img/4d56a8a7131d7cdf9a6117dd24c18845.image.png)

跳过1panel部署和域名申请等环节，直接开始域名证书申请

# 创建DNS账户
## 阿里云申请子账户

![image.png](https://cos.haowee.cn/img/e9ae77213f68b317c1c708bc2a30647c.image.png)

申请完成获取ak sk



## 配置

![image.png](https://cos.haowee.cn/img/003ee032bcb74e33369a123c22f75c01.image.png)

# 添加acme账户
填写自己的邮箱即可，其他配置默认

![image.png](https://cos.haowee.cn/img/706a1388bb20f4b8804e9a4d19071332.image.png)

# 申请证书
![image.png](https://cos.haowee.cn/img/6ecf07d4928713bc159aa93b72179acd.image.png)

域名使用泛域名*

dns、acme账户选择你配置的

开启自动续期

注意：

证书申请会往域名解析里面新增解析记录TXT记录，申请成功会删除这个txt记录，是正常现象，可能会有邮件提醒说删除了解析记录
# 使用

## 反向代理docker项目
演示it-tools项目

### 在ssl控制台申请一个子域名
比如tool.haowee.cn

### 部署项目
```
version: '3.9'
services:
    it-tools:
        image: 'corentinth/it-tools:latest'
        ports:
            - '8088:80'
        restart: unless-stopped
        container_name: it-tools
        networks:
            - 1panel-network   # 连接到 NPM 的网络

networks:
    1panel-network:
        external: true           # 声明该网络已存在，不要尝试创建
```

必须开启端口映射不然127.0.0.1不能访问

### 配置
勾选https选择对应的证书即可
![image.png](https://cos.haowee.cn/img/60a3fe0ad7078c70ed256f5c971e2055.image.png)

1panel申请泛域名证书

# 简介
Flutter 是 Google 开源的 UI 工具包，其核心理念是“一套代码，多端运行”。它最大的优势在于不依赖原生控件，而是通过自研的 Skia 图形引擎进行自主渲染，从而能提供接近原生的性能和高度的界面一致性。它使用简洁且支持异步编程的 Dart 语言进行开发。

以下是 Flutter 在 Windows、macOS 和 Linux 三大操作系统上的详细安装指南。



# 前置准备：配置中国区镜像 (可选但推荐)
在中国大陆安装 Flutter，建议为 SDK 和依赖包配置国内镜像站点，以确保下载速度和稳定性。

打开终端（Windows 使用 PowerShell 或 CMD）。

设置环境变量：根据你使用的操作系统，执行以下命令：

Windows (PowerShell):

```powershell
[System.Environment]::SetEnvironmentVariable('PUB_HOSTED_URL', 'https://pub.flutter-io.cn', 'User')
[System.Environment]::SetEnvironmentVariable('FLUTTER_STORAGE_BASE_URL', 'https://storage.flutter-io.cn', 'User')
```

macOS / Linux (终端):

```bash
export PUB_HOSTED_URL="https://pub.flutter-io.cn"
export FLUTTER_STORAGE_BASE_URL="https://storage.flutter-io.cn"
```

# Windows 安装指南
安装前置工具：

安装 Git for Windows。

（可选，用于构建Windows应用） 安装 Visual Studio 2022，在安装时务必勾选 “使用 C++ 的桌面开发” 工作负载。

下载与解压 SDK：

访问 Flutter 中文社区镜像网站 https://docs.flutter.cn/install/archive/
，下载 Windows 版本的 SDK 压缩包。

将压缩包解压到你指定的文件夹，例如 C:\src\flutter。

配置环境变量（PATH）：

右键点击“此电脑” -> “属性” -> “高级系统设置” -> “环境变量”。

在“用户变量”或“系统变量”中找到 Path 变量，并点击“编辑”。

点击“新建”，添加 Flutter SDK 的 bin 目录路径，例如 C:\src\flutter\bin。

验证安装：

打开一个新的 PowerShell 或 命令提示符 窗口。

执行 flutter doctor 命令，该命令会自动检查你缺少的依赖（如 Android SDK、IDE插件等）并给出提示。

# macOS 安装指南
安装前置工具：

Xcode：从 Mac App Store 安装 Xcode。安装后，在终端运行 sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer 和 sudo xcodebuild -runFirstLaunch 来完成设置，这对于 iOS 和 macOS 开发是必须的。运行 sudo xcodebuild -license 同意其许可协议。

命令行工具：终端运行 xcode-select --install 以安装 Git 等命令行工具。

下载与解压 SDK：

从 Flutter SDK 归档页面 下载 macOS 版本的 SDK 压缩包。

将文件解压到你想要的目录，例如 ~/development/flutter。

配置环境变量（PATH）：

打开终端，使用 nano 或 vim 编辑你的 Shell 配置文件。

如果你使用 zsh (macOS Catalina 及更新版本默认):

```bash
nano ~/.zshrc
```
如果你使用 bash (较旧版本):

```bash
nano ~/.bash_profile
```
在文件末尾添加以下行，将 bin 目录添加到 PATH 中:

```bash
export PATH="$PATH:$HOME/development/flutter/bin"
```
保存文件（nano 中按 Ctrl+X，然后按 Y 并回车），并运行 source ~/.zshrc (或 source ~/.bash_profile) 使配置生效。

验证安装：

执行 flutter doctor 命令，检查环境状态。

# Linux (以 Debian/Ubuntu 为例) 安装指南
安装前置工具：

在终端中执行以下命令以安装编译 Flutter 应用所必需的工具和库:

```bash
sudo apt-get update -y && sudo apt-get upgrade -y
sudo apt-get install -y curl git unzip xz-utils zip libglu1-mesa
sudo apt-get install -y clang cmake ninja-build pkg-config libgtk-3-dev libstdc++-12-dev

```
下载与解压 SDK：

从 Flutter SDK 归档页面 下载 Linux 版本的 SDK 压缩包。

将文件解压到用户目录，例如 ~/flutter：

```bash
cd ~
tar -xvf ~/Downloads/flutter_linux_*.tar.xz
```
配置环境变量（PATH）：

使用 nano 编辑你的 Shell 配置文件。

如果你使用 bash:

```bash
nano ~/.bashrc
```
如果你使用 zsh:

```bash
nano ~/.zshrc
```
在文件末尾添加以下行:

```bash
export PATH="$PATH:$HOME/flutter/bin"
```
保存文件并运行 source ~/.bashrc (或 source ~/.zshrc) 使配置生效。

验证安装：

执行 flutter doctor 命令，检查环境状态。

通用下一步：完成安装与开发工具
无论使用哪个平台，在执行 flutter doctor 后，请根据其输出提示完成以下步骤：

安装开发工具：建议安装 Visual Studio Code，并在其扩展市场中安装 Flutter 和 Dart 插件。

安装 Android 开发环境：下载并安装 Android Studio，完成 Android SDK 的安装和许可。之后在终端执行 flutter doctor --android-licenses 接受许可。

安装 iOS 开发环境：(仅限 macOS) 通过 Xcode 完成 iOS 和 macOS 环境的配置。

如果这些步骤你都顺利完成了，接下来就可以创建你的第一个Flutter应用，开始跨平台开发的旅程啦～

flutter安装

AppleId换区

在 Ubuntu 上开启 Swap 主要推荐使用**交换文件**的方式，因为它方便管理，并且在需要调整大小时也更灵活。以下是完整的操作流程。

### 📝 操作流程概览

1.  检查是否已有 Swap
2.  创建并指定 Swap 文件大小
3.  设置严格的文件权限
4.  将文件格式化为 Swap
5.  启用 Swap 文件
6.  写入 fstab 实现开机自动挂载
7.  验证配置是否成功
8.  (可选) 优化系统 swappiness 参数

---



### 📋 详细步骤

整个流程都在终端中操作。

```bash
# 1. 查看当前 Swap 状态，确认是否有现成配置
sudo swapon --show
free -h
```

**1. 创建 Swap 文件**
使用 `fallocate` 指令可以快速创建一个指定大小的文件，其中 `4G` 是文件大小。
```bash
sudo fallocate -l 4G /swapfile
```
如果 `fallocate` 命令不可用，可使用 `dd` 命令作为备选。
```bash
sudo dd if=/dev/zero of=/swapfile bs=1M count=4096 status=progress
```

**2. 设置文件权限**
为确保安全，Swap 文件必须只能被 `root` 用户读写。
```bash
sudo chmod 600 /swapfile
```

**3. 格式化为 Swap 空间**
使用 `mkswap` 工具将文件设置为 Swap 格式。
```bash
sudo mkswap /swapfile
```

**4. 立即启用 Swap**
启用文件，让系统开始使用它。
```bash
sudo swapon /swapfile
```

**5. 验证是否启用**
再次检查，确认新的 Swap 空间已生效。
```bash
sudo swapon --show
free -h
```

**6. 设置开机自动挂载**
为了避免重启后失效，需要将配置添加到系统文件`/etc/fstab`中。下面的命令会自动添加一行。
```bash
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab
```

### ⚙️ 优化建议：调整 Swappiness 参数

Ubuntu 默认的 `swappiness` 值为 60，代表当物理内存使用率达到约 40% 时，系统就会开始使用 Swap，对于内存充裕的机器来说可能过于积极。可以将其调低，让系统更优先使用物理内存。

通过以下命令查看当前值：
```bash
cat /proc/sys/vm/swappiness
```

建议设置为 10，这会让系统仅在内存紧张时才使用 Swap，对于桌面系统或服务器是不错的平衡点。
```bash
# 临时设置，立即生效，重启后失效
sudo sysctl vm.swappiness=10

# 永久设置，将配置写入系统文件
echo 'vm.swappiness=10' | sudo tee -a /etc/sysctl.conf
```

### 🗑️ 如何移除或调整 Swap 空间

如果你想**移除**已配置的 Swap，可以先关闭它，然后删除文件和 fstab 中的配置行。
```bash
sudo swapoff /swapfile
sudo rm /swapfile
sudo vim /etc/fstab   # 然后手动删除包含 '/swapfile' 的那一行
```

如果需要**调整 Swap 大小**，首先关闭当前文件，然后重新执行“创建到启用”的步骤即可。
```bash
sudo swapoff /swapfile
sudo rm /swapfile
# 重新执行上面的"创建"到"启用"的步骤即可
```

### 🎯 如何选择合适的 Swap 大小

Swap 的大小没有一个放之四海而皆准的标准，可以根据你的物理内存总量和实际使用需求来参考：

| 物理内存大小 | 推荐 Swap 大小 | 适用场景说明 |
| :--- | :--- | :--- |
| **≤ 2GB** | 内存的 1-2 倍 | 内存较小，Swap 作为重要的内存补充。 |
| **2GB - 8GB** | 与内存大小相等 | 较为通用的配置，能在容量和性能间取得平衡。 |
| **8GB - 16GB** | 4GB - 8GB | 物理内存相对充足，Swap 主要用于应对偶发的内存峰值。 |
| **≥ 16GB** | 4GB - 8GB | 大内存设备，Swap 主要作为“保险丝”防止 OOM，无需过大。 |
| **需要休眠功能** | ≥ 物理内存大小 | 系统休眠时会将 RAM 内容全部写入 Swap，因此 Swap 容量必须足够大。 |

### 💡 其他注意事项
- **首选交换文件**：与传统的交换分区相比，交换文件无需预先规划磁盘分区，调整大小也更加简单，是现代 Linux 系统的推荐做法。
- **注意存储性能与寿命**：如果使用 SSD 作为存储介质，Swap 的读写可能会略微影响其寿命。建议适当降低 `swappiness` 值以减少对 SSD 的写入。

Ubuntu开启Swap

# Docker网络配置实战：Nginx代理跨容器服务与网络最佳实践

## 背景与需求

用户希望在一个 Docker 环境中，让 Nginx（或 Nginx Proxy Manager）代理另一个运行在 8083 端口的服务（例如 drawdb 或 vanblog）。核心难点在于：两个容器可能位于不同的网络，且需要解决容器间通信的网络配置问题。

## 一、Nginx 代理其他 Docker 服务的基本原理

### 1.1 核心要点

Nginx 容器不能直接使用 `localhost` 或 `127.0.0.1` 访问其他容器，因为每个容器有独立的网络命名空间。

要让容器间通信，推荐将两个容器放入**同一个自定义的 Docker bridge 网络**。

在同一自定义网络中，可以通过**容器名（或服务名）** 作为主机名，配合容器内部端口进行访问。

### 1.2 示例：Nginx 配置中的代理地址

```nginx
proxy_pass http://backend-app:8083;
```

其中 `backend-app` 是后端服务的容器名，`8083` 是容器内部监听的端口（**不是**宿主机映射端口）。



## 二、为什么不用默认的 bridge 网络？

Docker 安装后会创建一个名为 `bridge`（或称 `docker0`）的默认网络。但它有致命缺点：

| 特性 | 默认 bridge | 自定义 bridge |
|------|-------------|---------------|
| 容器名自动 DNS 解析 | ❌ 不支持 | ✅ 支持 |
| 需要使用已废弃的 `--link` | 是 | 否 |
| 容器重启后 IP 变化 | 需要手动更新配置 | 容器名不变，不受影响 |
| 生产环境推荐程度 | ⭐ | ⭐⭐⭐⭐⭐ |

**结论：必须创建自定义 bridge 网络，而不是使用默认的 bridge。**

## 三、创建自定义网络并连接容器

### 3.1 创建网络

```bash
docker network create app-network
```

### 3.2 启动容器时加入网络

```bash
# 后端服务
docker run -d --name backend-app --network app-network your-backend-image

# Nginx 容器
docker run -d --name nginx --network app-network -p 80:80 nginx
```

### 3.3 如果容器已经运行，可以动态连接网络

```bash
docker network connect app-network nginx
```

## 四、使用 Docker Compose 管理网络

实际部署中推荐使用 `docker-compose.yml`，Compose 会自动为项目创建一个默认的自定义网络，并且服务之间可以直接用服务名通信。

### 4.1 基础示例

```yaml
version: '3.9'
services:
  backend:
    image: xinsodev/drawdb
    container_name: drawdb
    ports:
      - "8083:80"      # 可选，如通过 Nginx 代理可不映射宿主机端口
    restart: unless-stopped

  nginx:
    image: nginx
    ports:
      - "80:80"
    volumes:
      - ./nginx.conf:/etc/nginx/conf.d/default.conf
    restart: unless-stopped
```

在此 Compose 文件中，不显式定义网络，Compose 会创建默认网络（名称格式：`目录名_default`）。服务 `nginx` 可以通过 `http://backend:80` 访问 `backend`。

### 4.2 连接已存在的外部网络（例如 Nginx Proxy Manager 的网络）

如果已经有了一个由其他项目创建的网络（如 `nginx-proxy-manager_default` 或 `1panel-network`），需要让新服务加入该网络，并声明该网络为 `external`。

**正确配置示例（针对 drawdb）**

```yaml
version: '3.9'

services:
  drawdb:
    image: xinsodev/drawdb
    ports:
      - '8083:80'          # 可选，若通过 NPM 代理可删除
    restart: unless-stopped
    container_name: drawdb
    networks:
      - 1panel-network

networks:
  1panel-network:
    external: true         # 关键：表示该网络已存在，不要尝试创建
```

**另一示例：让 Nginx Proxy Manager 自己也加入外部网络**

原用户提供的 NPM 配置中存在 YAML 缩进错误，修正后如下：

```yaml
services:
  app:
    image: 'jc21/nginx-proxy-manager:latest'
    restart: unless-stopped
    environment:
      TZ: "Asia/Shanghai"
    ports:
      - '80:80'
      - '81:81'
      - '443:443'
    volumes:
      - ./data:/data
      - ./letsencrypt:/etc/letsencrypt
    networks:
      - 1panel-network      # ✅ 必须与 volumes 平级

networks:
  1panel-network:
    external: true
```

## 五、常见问题与解答

### 5.1 网络创建后能否改名？

不能直接重命名。Docker 不允许修改已有网络的名称。若需要改名，只能：

1. 创建新网络（`docker network create new-name`）
2. 迁移所有容器到新网络
3. 删除旧网络（`docker network rm old-name`）

### 5.2 不同 bridge 网络之间能否通过网关 IP 访问？

不能。Docker 的不同 bridge 网络默认隔离，即使知道另一个网络的网关 IP 也无法路由。必须将容器加入同一网络，或通过端口映射到宿主机（`-p`）后使用宿主机 IP 访问。

### 5.3 如何使用 host.docker.internal？

该 DNS 名称仅在 Docker Desktop (Mac/Windows) 中有效，用于从容器访问宿主机。Linux 下默认不可用，除非使用 `--add-host=host.docker.internal:host-gateway` 参数。

### 5.4 端口映射与内部通信的区别

- **端口映射**（`-p 8083:80`）：将容器端口暴露给宿主机，外部或其他网段的容器可以通过 `宿主机IP:8083` 访问。
- **直接内部通信**（通过自定义网络 + `容器名:内部端口`）：性能更高、更安全，且不需要暴露端口到宿主机。

## 六、一个完整的实战案例：VanBlog + Nginx Proxy Manager

用户有一个 vanblog 服务（含 MongoDB），需要加入 `1panel-network` 以便 Nginx Proxy Manager 代理。

### 6.1 修改后的 docker-compose.yml

```yaml
version: "3"

services:
  vanblog:
    image: mereith/van-blog:latest
    restart: always
    depends_on:
      mongo:
        condition: service_healthy
    environment:
      TZ: "Asia/Shanghai"
      EMAIL: ""
    volumes:
      - /var/vanblog/data/static:/app/static
      - /var/vanblog/log:/var/log
      - /var/vanblog/caddy/config:/root/.config/caddy
      - /var/vanblog/caddy/data:/root/.local/share/caddy
    ports:
      - 8080:80
      - 4433:443
    networks:
      - 1panel-network

  mongo:
    image: mongo:4.4.16
    restart: always
    environment:
      TZ: "Asia/Shanghai"
    volumes:
      - /var/vanblog/data/mongo:/data/db
    healthcheck:
      test: echo 'db.runCommand("ping").ok' | mongo localhost:27017/test --quiet
      interval: 10s
      timeout: 5s
      retries: 5
    networks:
      - 1panel-network

networks:
  1panel-network:
    external: true
```

### 6.2 在 Nginx Proxy Manager 中添加代理

- **Scheme**: http
- **Forward Hostname / IP**: `vanblog`（容器名）
- **Forward Port**: `80`（vanblog 内部监听端口）

## 七、网络名称命名建议

- ✅ 语义化：如 `proxy-network`、`app-network`、`1panel-network`、`nginx-proxy-manager_default`
- ✅ 只使用字母、数字、下划线、连字符
- ❌ 避免使用 `bridge`、`network1` 等过于通用的名称
- ❌ 避免使用特殊字符或空格
- ❌ 名称不宜过长，但也要清晰

如果用户已经有一个由 Nginx Proxy Manager 或 1Panel 创建的网络，强烈建议直接复用该网络，而不是另建新网络，这样可以减少网络碎片。

## 八、总结与最佳实践

- 始终使用自定义 bridge 网络，不要依赖默认的 bridge。
- 容器间通信使用 `容器名:内部端口`，不要使用宿主机 IP 或映射端口（除非不得已）。
- 在 `docker-compose.yml` 中，若需引用已存在的网络，必须添加 `external: true`。
- 注意 YAML 缩进：`networks` 字段应位于服务定义下的顶层，与 `volumes`、`ports` 平级。
- 验证连通性：使用 `docker exec -it nginx-container /bin/sh` 进入容器，执行 `ping backend-container` 或 `curl http://backend-container:port`。
- 网络一旦创建无法改名，规划好命名后再创建。

## 附录：常用命令

```bash
# 查看所有网络
docker network ls

# 查看某个网络的详细信息（包括连接的容器）
docker network inspect my-network

# 创建自定义 bridge 网络
docker network create my-network

# 将运行中的容器连接到网络
docker network connect my-network container-name

# 断开容器与网络
docker network disconnect my-network container-name

# 删除网络（需先断开所有容器）
docker network rm my-network
```