@elf-express/admin-net-mcp 1.0.0 → 1.1.0

package/knowledge/Furion_Teaching_Manual/33-IPC/347/250/213/345/272/217/351/200/232/350/250/212.md

@@ -0,0 +1,98 @@
+# 33. IPC 程序通訊
+
+---
+
+## 33.1 概述
+
+IPC（Inter-Process Communication）是指不同程序之間的資料交互。Furion 框架內建了**程序內**和**程序外**兩種通訊模式：
+
+| 模式 | 實作方式 | 狀態 |
+|------|---------|------|
+| **程序內通訊**（執行緒間） | `Channel` 管道 | ✅ 已實作 |
+| **程序外通訊**（跨程序） | `MemoryMappedFile` 共享記憶體 | 🔜 後續版本 |
+
+---
+
+## 33.4 程序內通訊（執行緒間）
+
+採用 `Channel`（管道）+ `Lazy` + `Task.Factory` 實現高效能的執行緒間通訊，是 .NET 實現**生產者-消費者**模式最簡易且強大的方式。
+
+### Channel 兩種模式
+
+| 模式 | 說明 | 建議 |
+|------|------|------|
+| `UnBoundedChannel` | 無限容量，生產者全速生產，有記憶體耗盡風險 | — |
+| `BoundedChannel` | 有限容量（預設 1000），超過上限生產者等待 | ✅ 推薦 |
+
+### 33.4.2 基本使用
+
+**建立管道處理程式**：
+
+```csharp
+using Furion.IPCChannel;
+
+public class MyChannelHandler : ChannelHandler<string>
+{
+    public override Task InvokeAsync(string message)
+    {
+        Console.WriteLine(message);
+        return Task.CompletedTask;
+    }
+}
+```
+
+> `ChannelHandler<TMessage>` 的泛型型別決定接收的訊息類型，不同型別自動過濾。
+
+**發送訊息**：
+
+```csharp
+public async Task SendAsync()
+{
+    for (int i = 0; i < 100; i++)
+    {
+        // 非同步寫入（有限容量管道）
+        await ChannelContext<string, MyChannelHandler>.BoundedChannel.Writer.WriteAsync($"Loop {i} times.");
+
+        // 也可同步寫入
+        // ChannelContext<string, MyChannelHandler>.BoundedChannel.Writer.TryWrite($"Loop {i} times.");
+    }
+}
+```
+
+### 33.4.3 實現多訂閱
+
+預設初始化一個長時間 Task 進行訂閱，如需多訂閱可建立新的讀取器：
+
+```csharp
+var reader = ChannelContext<string, MyChannelHandler>.BoundedChannel.Reader;
+
+_ = Task.Factory.StartNew(async () =>
+{
+    while (await reader.WaitToReadAsync())
+    {
+        if (!reader.TryRead(out var message)) continue;
+        // 預設重試 3 次（每次間隔 1s）
+        await Retry.InvokeAsync(async () =>
+            await Activator.CreateInstance<MyChannelHandler>().InvokeAsync(message),
+            3, 1000, finalThrow: false);
+    }
+}, TaskCreationOptions.LongRunning);
+```
+
+### 33.4.5 CallContext 方式
+
+Furion v2.18+ 提供 `CallContext` 靜態類（基於 `AsyncLocal<T>`），也可實現執行緒間通訊：
+
+```csharp
+CallContext.SetLocalValue("name", "Furion");
+var name = CallContext.GetLocalValue("name");
+
+CallContext<int>.SetLocalValue("count", 1);
+var count = CallContext<int>.GetLocalValue("count");
+```
+
+---
+
+## 33.5 程序外通訊（共享記憶體）
+
+計畫透過 `MemoryMappedFile` 實現跨程序共享記憶體通訊，目前尚未開放，將在後續版本提供。

package/knowledge/Furion_Teaching_Manual/34-2-Docker/351/203/250/347/275/262.md

@@ -0,0 +1,313 @@
+# 34.2 Docker 部署
+
+---
+
+## 34.2.1 概述
+
+Docker 是開源的應用容器引擎，透過容器技術實現「一次建置，到處運行」。官方網站：https://www.docker.com/
+
+### 精簡發佈檔案
+
+```xml
+<PropertyGroup>
+  <TargetFramework>net6.0</TargetFramework>
+  <SatelliteResourceLanguages>en-US</SatelliteResourceLanguages>
+</PropertyGroup>
+
+<!-- 不產生 .pdb 檔案 -->
+<PropertyGroup Condition=" '$(Configuration)' == 'Release' ">
+  <DebugType>none</DebugType>
+  <DebugSymbols>false</DebugSymbols>
+</PropertyGroup>
+```
+
+---
+
+## 34.2.2 Dockerfile
+
+### Visual Studio 自動產生（推薦）
+
+1. 啟動層專案 → 右鍵 → 新增 → Docker 支援 → 選擇 **Linux**
+2. 將 `Dockerfile` 移動到解決方案根目錄（與 `.sln` 同級）
+3. 編輯 `.csproj` 加入：
+
+```xml
+<PropertyGroup>
+  <DockerDefaultTargetOS>Linux</DockerDefaultTargetOS>
+  <DockerfileFile>..\Dockerfile</DockerfileFile>
+</PropertyGroup>
+<ItemGroup>
+  <None Include="..\Dockerfile"><Link>Dockerfile</Link></None>
+</ItemGroup>
+```
+
+### 手動編寫（.NET 6 範例）
+
+```dockerfile
+FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS base
+WORKDIR /app
+EXPOSE 80
+EXPOSE 443
+
+FROM mcr.microsoft.com/dotnet/sdk:6.0 AS build
+ARG BUILD_CONFIGURATION=Release
+WORKDIR /src
+COPY ["YourProject.Web.Entry/YourProject.Web.Entry.csproj", "YourProject.Web.Entry/"]
+COPY ["YourProject.Application/YourProject.Application.csproj", "YourProject.Application/"]
+COPY ["YourProject.Core/YourProject.Core.csproj", "YourProject.Core/"]
+RUN dotnet restore "./YourProject.Web.Entry/YourProject.Web.Entry.csproj"
+COPY . .
+WORKDIR "/src/YourProject.Web.Entry"
+RUN dotnet build "./YourProject.Web.Entry.csproj" -c $BUILD_CONFIGURATION -o /app/build
+
+FROM build AS publish
+ARG BUILD_CONFIGURATION=Release
+RUN dotnet publish "./YourProject.Web.Entry.csproj" -c $BUILD_CONFIGURATION -o /app/publish /p:UseAppHost=false
+
+FROM base AS final
+WORKDIR /app
+COPY --from=publish /app/publish .
+ENTRYPOINT ["dotnet", "YourProject.Web.Entry.dll"]
+```
+
+### 已手動發佈的簡化版
+
+```dockerfile
+FROM mcr.microsoft.com/dotnet/aspnet:6.0
+WORKDIR /app
+EXPOSE 80
+EXPOSE 443
+COPY . .
+ENTRYPOINT ["dotnet", "YourProject.Web.Entry.dll"]
+```
+
+---
+
+## 34.2.3 建置映像檔
+
+```bash
+docker build -t your-project:1.0 .
+docker images ls  # 查看映像檔列表
+```
+
+## 34.2.4 執行映像檔
+
+```bash
+# 執行（映像檔 → 容器）
+docker run --name yourproject -p 8090:80 --restart=always -d your-project:1.0
+
+# 查看日誌
+docker logs yourproject
+
+# 進入容器
+docker exec -it yourproject bash
+```
+
+---
+
+## 34.2.5 發佈映像檔（Docker Hub）
+
+```bash
+# 打標籤
+docker tag your-project:1.0 username/tests:1.0
+
+# 登入
+docker login
+
+# 推送
+docker push username/tests:1.0
+
+# 其他人即可執行
+docker run --name tests -p 8091:80 --restart=always -d username/tests:1.0
+```
+
+---
+
+## 34.2.6 私有倉庫
+
+### Docker Registry（輕量級）
+
+```bash
+# 啟動 Registry
+docker run --name registry -p 9000:5000 -v /path/to/images:/var/lib/registry --restart always -d registry:2
+
+# 打標籤並推送
+docker tag your-project:1.0 localhost:9000/monksoul/tests:1.0
+docker push localhost:9000/monksoul/tests:1.0
+
+# 查看倉庫
+# http://localhost:9000/v2/_catalog
+```
+
+> 需在 Docker Engine 設定中加入 `"insecure-registries": ["localhost:9000"]`。
+
+### Harbor（推薦，企業級）
+
+Harbor 提供 RBAC、映像簽名、複製、LDAP 整合等企業級功能。
+
+```bash
+# 下載並解壓
+wget https://github.com/goharbor/harbor/releases/download/v2.9.2/harbor-offline-installer-v2.9.2.tgz
+tar -zxf harbor-offline-installer-v2.9.2.tgz
+cp harbor.yml.tmpl harbor.yml
+
+# 編輯 harbor.yml（設定 hostname、port、https 等）
+# 安裝
+sudo ./install.sh
+
+# 推送映像
+docker tag your-project:1.0 localhost:9001/project-name/tests:1.0
+docker login localhost:9001
+docker push localhost:9001/project-name/tests:1.0
+```
+
+> 預設帳號密碼：`admin` / `Harbor12345`。啟用 Trivy 漏洞掃描：`sudo ./install.sh --with-trivy`。
+
+---
+
+## 34.2.7 資料卷（Volume）
+
+資料卷用於持久化資料、容器間共享、效能優化。最佳實踐：將容器設計為**無狀態容器**。
+
+```bash
+# 掛載本機目錄到容器
+docker run --name vol1 -p 8094:80 -v /host/path:/app/configs --restart=always -d vol:0.1
+
+# 從容器複製檔案到本機
+docker cp vol1:/app/configs_temp/ /host/path/
+```
+
+Dockerfile 中宣告資料卷：
+
+```dockerfile
+COPY YourProject.Web.Entry/configs/* /app/configs_temp/
+VOLUME /app/configs
+```
+
+---
+
+## 34.2.8 Docker Compose
+
+透過 `docker-compose.yml` 定義和執行多容器應用。
+
+### 範例
+
+```yaml
+version: '3.8'
+
+services:
+  first-mssql:
+    container_name: first-mssql
+    image: mcr.microsoft.com/mssql/server
+    environment:
+      - ACCEPT_EULA=Y
+      - SA_PASSWORD=YourPassword!123
+      - MSSQL_PID=Express
+    ports:
+      - 1433:1433
+
+  first-mysql:
+    container_name: first-mysql
+    image: mysql
+    environment:
+      - MYSQL_ROOT_PASSWORD=123456
+    ports:
+      - 3306:3306
+
+  first-nginx:
+    container_name: first-nginx
+    image: nginx
+    ports:
+      - 8081:80
+```
+
+```bash
+docker-compose up -d        # 啟動
+docker-compose down          # 停止並刪除
+docker-compose up --build    # 重新建置
+docker-compose ps            # 查看狀態
+docker-compose logs          # 查看日誌
+```
+
+---
+
+## 34.2.9 常見問題
+
+### 無 HTTPS 憑證
+
+若設定了 `https://` URL 但未提供憑證，映像檔啟動會失敗。解法：提供有效憑證或移除 https URL。
+
+### DateTime.Now 時區問題
+
+```dockerfile
+ENV TZ=Asia/Taipei
+RUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && echo $TZ > /etc/timezone
+```
+
+### 國內映像加速
+
+```json
+{
+  "registry-mirrors": [
+    "https://registry.docker-cn.com",
+    "https://docker.mirrors.ustc.edu.cn"
+  ]
+}
+```
+
+---
+
+## 34.2.11 參考資料
+
+### 前端 Dockerfile 範例（Vue/React/Angular）
+
+```dockerfile
+FROM nginx:stable-alpine
+RUN rm /etc/nginx/conf.d/default.conf
+COPY nginx.conf /etc/nginx/conf.d/
+COPY build /usr/share/nginx/html
+EXPOSE 80
+CMD ["nginx", "-g", "daemon off;"]
+```
+
+### Docker 常用命令速查
+
+| 命令 | 說明 |
+|------|------|
+| `docker build -t name:tag .` | 建置映像檔 |
+| `docker run --name c -p 80:80 -d img` | 執行容器 |
+| `docker images ls` | 映像檔列表 |
+| `docker container ps -a` | 所有容器 |
+| `docker start/stop/restart name` | 啟動/停止/重啟 |
+| `docker logs name` | 查看日誌 |
+| `docker exec -it name bash` | 進入容器 |
+| `docker rm -f name` | 強制刪除容器 |
+| `docker rmi name:tag` | 刪除映像檔 |
+| `docker cp container:path host_path` | 複製檔案 |
+
+### Docker Compose 常用命令速查
+
+| 命令 | 說明 |
+|------|------|
+| `docker-compose up -d` | 背景啟動 |
+| `docker-compose down` | 停止並刪除 |
+| `docker-compose up --build` | 重新建置 |
+| `docker-compose ps` | 查看服務 |
+| `docker-compose logs` | 查看日誌 |
+| `docker-compose exec svc bash` | 進入服務 |
+| `docker-compose restart svc` | 重啟服務 |
+
+### Dockerfile 常用指令速查
+
+| 指令 | 說明 |
+|------|------|
+| `FROM` | 指定基礎映像檔 |
+| `WORKDIR` | 設定工作目錄 |
+| `COPY` / `ADD` | 複製檔案（ADD 支援 URL） |
+| `RUN` | 建置時執行命令 |
+| `CMD` | 容器啟動時執行命令 |
+| `ENTRYPOINT` | 容器啟動後第一個命令 |
+| `EXPOSE` | 宣告埠號 |
+| `ENV` | 設定環境變數 |
+| `VOLUME` | 宣告資料卷 |
+| `USER` | 設定執行使用者 |

package/knowledge/Furion_Teaching_Manual/34-3-Nginx/351/203/250/347/275/262.md

@@ -0,0 +1,157 @@
+# 34.3 Nginx 部署
+
+---
+
+## 34.3.1 概述
+
+Nginx 是一款高效能的 HTTP 伺服器 / 反向代理伺服器，支援同時處理上萬個並行連線，CPU 和記憶體消耗極低。
+
+---
+
+## 34.3.2 安裝 Nginx
+
+### Linux / Mac OS
+
+```bash
+sudo apt-get update
+sudo apt install nginx
+sudo systemctl start nginx
+sudo systemctl enable nginx
+sudo systemctl status nginx
+```
+
+### Windows
+
+1. 從 https://nginx.org/en/download.html 下載 nginx
+2. 下載 [NSSM](https://nssm.cc/) 並解壓，進入 `win64` 目錄
+3. 執行 `nssm install nginx_service`（或 `./nssm.exe install nginx_service`）
+4. 指定 `nginx.exe` 路徑 → Install service
+5. 啟動 `nginx_service` 服務
+
+> 若 IIS 佔用 80 埠，需先停止該站點。安裝 Nginx 後可透過 `proxy_pass` 轉發到任意埠。
+
+---
+
+## 34.3.3 網站設定
+
+### 34.3.3.1 部署 ASP.NET Core 網站
+
+先透過 pm2、IIS 或 Windows Service 將 ASP.NET Core 部署到非 80/443 埠（如 8090）。
+
+**取得真實 IP 地址**：
+
+```csharp
+// 方式一：Configure 中設定
+app.UseForwardedHeaders(new ForwardedHeadersOptions
+{
+    ForwardedHeaders = ForwardedHeaders.XForwardedFor | ForwardedHeaders.XForwardedProto
+});
+
+// 方式二：若仍取得代理 IP，改用此設定
+services.Configure<ForwardedHeadersOptions>(options =>
+{
+    options.ForwardedHeaders = ForwardedHeaders.All;
+    options.KnownNetworks.Clear();
+    options.KnownProxies.Clear();
+});
+app.UseForwardedHeaders(); // 確保第一個註冊
+```
+
+### 34.3.3.2 設定檔位置
+
+| 系統 | 路徑 |
+|------|------|
+| Linux / Mac | `/etc/nginx/conf.d/` |
+| Windows | `nginx 安裝目錄/conf/` |
+
+### 34.3.3.3 HTTP 設定
+
+在 `conf.d` 或 `conf` 目錄新增 `yoursite.com.conf`：
+
+```nginx
+http {
+  map $http_connection $connection_upgrade {
+    "~*Upgrade" $http_connection;
+    default keep-alive;
+  }
+
+  server {
+    listen 80;
+    listen [::]:80;
+    server_name yoursite.com;  # 無域名可不寫
+
+    location / {
+      proxy_pass http://localhost:8090;
+      proxy_http_version 1.1;
+      proxy_set_header Upgrade $http_upgrade;
+      proxy_set_header Connection $connection_upgrade;
+      proxy_set_header Host $host;
+      proxy_cache_bypass $http_upgrade;
+      proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+      proxy_set_header X-Forwarded-Proto $scheme;
+    }
+  }
+}
+```
+
+### 34.3.3.4 重啟 / 重載設定
+
+```bash
+# Linux / Mac
+sudo systemctl restart nginx
+# 或僅重載設定
+nginx -s reload
+
+# Windows（NSSM）
+nssm restart nginx_service
+```
+
+---
+
+## 34.3.4 HTTPS 設定
+
+推薦使用 [certbot](https://certbot.eff.org/) 產生免費 HTTPS 憑證（支援自動續期）。
+
+```nginx
+http {
+  map $http_connection $connection_upgrade {
+    "~*Upgrade" $http_connection;
+    default keep-alive;
+  }
+
+  # HTTPS
+  server {
+    listen 443 ssl;
+    server_name yoursite.com;
+
+    ssl_certificate /etc/letsencrypt/live/yoursite.com/fullchain.pem;
+    ssl_certificate_key /etc/letsencrypt/live/yoursite.com/privkey.pem;
+    ssl_session_cache shared:SSL:1m;
+    ssl_session_timeout 5m;
+    ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:ECDHE:ECDH:AES:HIGH:!NULL:!aNULL:!MD5:!ADH:!RC4;
+    ssl_protocols TLSv1.1 TLSv1.2 TLSv1.3;
+    ssl_prefer_server_ciphers on;
+
+    location / {
+      proxy_pass http://localhost:8090;
+      proxy_http_version 1.1;
+      proxy_set_header Upgrade $http_upgrade;
+      proxy_set_header Connection $connection_upgrade;
+      proxy_set_header Host $host;
+      proxy_cache_bypass $http_upgrade;
+      proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+      proxy_set_header X-Forwarded-Proto $scheme;
+    }
+  }
+
+  # HTTP → HTTPS 重新導向
+  server {
+    listen 80;
+    listen [::]:80;
+    server_name yoursite.com;
+    rewrite ^(.*)$ https://$host$1 permanent;
+  }
+}
+```
+
+> 重啟 / 重載 Nginx 設定即可生效。

package/knowledge/Furion_Teaching_Manual/34-8-WindowsService/351/203/250/347/275/262.md

@@ -0,0 +1,112 @@
+# 34.8 Windows Service 部署
+
+---
+
+## 34.8.1 概述
+
+Windows Service 是 Windows 作業系統中的後台程序，獨立於使用者登入狀態，系統啟動時自動啟動，不顯示 UI，透過服務控制管理員（SCM）與作業系統互動。
+
+## 34.8.2 關於 NSSM
+
+NSSM 可將普通 `.exe` 或 `.bat` 封裝成 Windows 服務執行。
+
+- 官網：http://nssm.cc/
+- 下載：nssm-2.24.zip（免安裝）
+
+---
+
+## 34.8.3 發佈網站
+
+1. 選擇啟動專案 → 右鍵 → 發佈 → 發佈到資料夾
+2. 設定發佈目錄、編輯發佈設定（通常預設即可）
+3. 點擊發佈
+
+## 34.8.4 設定伺服器 .NET 環境
+
+> 若選擇單檔案/獨立發佈模式，可跳過此步驟。
+
+1. 安裝 [.NET Core 執行階段捆綁包](https://dotnet.microsoft.com/download)
+2. 執行：
+
+```powershell
+net stop was /y
+net start w3svc
+set ASPNETCORE_ENVIRONMENT=Production
+```
+
+---
+
+## 34.8.5 建立網站服務
+
+### .exe 方式
+
+1. 進入 NSSM 的 `win64` 目錄，開啟 PowerShell：
+
+```powershell
+./nssm.exe install MyProject
+```
+
+2. 選擇發佈目錄中的 `.exe` 檔案 → Install service
+3. 啟動服務：
+
+```powershell
+nssm start MyProject
+```
+
+4. 開啟 `http://localhost:5000` 存取（預設埠 5000）
+
+### .bat 方式（推薦）
+
+支援透過 `dotnet` 命令啟動，可自由設定埠等參數。
+
+1. 在發佈目錄建立 `MyProject.bat`：
+
+```bat
+pushd "C:\Workspace\TestPublish"
+dotnet Furion.Web.Entry.dll --urls=http://0.0.0.0:8089
+pause
+```
+
+2. 透過 NSSM 建立服務：
+
+```powershell
+./nssm.exe install MyProject
+```
+
+3. 選擇 `MyProject.bat` → Install service
+4. 啟動服務：
+
+```powershell
+nssm start MyProject
+```
+
+5. 開啟 `http://localhost:8089` 存取
+
+---
+
+## 34.8.6 刪除服務
+
+```powershell
+nssm stop MyProject
+nssm remove MyProject
+```
+
+---
+
+## 34.8.7 NSSM 常用命令
+
+| 命令 | 說明 |
+|------|------|
+| `nssm install 服務名` | 安裝服務 |
+| `nssm remove 服務名` | 刪除服務 |
+| `nssm remove 服務名 confirm` | 刪除服務（免確認） |
+| `nssm edit 服務名` | 修改服務（顯示介面） |
+| `nssm start 服務名` | 啟動服務 |
+| `nssm stop 服務名` | 停止服務 |
+| `nssm restart 服務名` | 重啟服務 |
+
+> 更多命令：https://nssm.cc/commands
+
+## 34.8.8 開啟 Windows Service 管理
+
+`Win + R` → 輸入 `services.msc` → Enter。