diff --git a/README.md b/README.md
index 35352bb..f954ce8 100644
--- a/README.md
+++ b/README.md
@@ -6,7 +6,7 @@
image/ 自建镜像:每个目录 = Dockerfile + build.sh,目录名即镜像 tag
app/ 部署编排:每个目录 = docker-compose.yml + install.sh / shutdown.sh + run.md(+demo.png)
app/ansible 例外:基于 runtime-python310 构建 ansible 镜像
-demo/ 构建示例:演示如何基于 image/ 下的镜像做两阶段构建
+demo/ 构建示例:演示如何基于 image/ 下的镜像做两阶段构建(dotnet6 / dotnet8 / dotnet9)
```
### 使用约定
@@ -32,8 +32,8 @@ demo/ 构建示例:演示如何基于 image/ 下的镜像做两阶段构建
| `image/runtime-dotnet8` | `kenaito:runtime-dotnet8` | 上者 / ASP.NET Core 运行时 8.0.x | 运行环境,仅运行时 |
| `image/runtime-dotnet9` | `kenaito:runtime-dotnet9` | 上者 / ASP.NET Core 运行时 9.0.x | 运行环境,仅运行时 |
| `image/compile-dotnet6` | `kenaito:compile-dotnet6` | 上者 / .NET SDK 6.0.427 | 编译环境(SDK + 编译工具链),两阶段构建示例见 `demo/dotnet6` |
-| `image/compile-dotnet8` | `kenaito:compile-dotnet8` | 上者 / .NET SDK 8.0.403 | 编译环境(SDK + 编译工具链) |
-| `image/compile-dotnet9` | `kenaito:compile-dotnet9` | 上者 / .NET SDK 9.0.100-rc.2 | 编译环境(SDK + 编译工具链) |
+| `image/compile-dotnet8` | `kenaito:compile-dotnet8` | 上者 / .NET SDK 8.0.403 | 编译环境(SDK + 编译工具链),两阶段构建示例见 `demo/dotnet8` |
+| `image/compile-dotnet9` | `kenaito:compile-dotnet9` | 上者 / .NET SDK 9.0.100-rc.2 | 编译环境(SDK + 编译工具链),两阶段构建示例见 `demo/dotnet9` |
| `image/proxy-tengine3` | `kenaito:proxy-tengine3` | 上者 / Tengine 3.1.0 源码编译 | 反向代理 / Web 服务器,自定义 `nginx.conf` |
| `app/ansible` | `kenaito:ansible` | 上者 / Ansible(基于 runtime-python310) | 运维工具镜像 |
diff --git a/demo/dotnet8/.dockerignore b/demo/dotnet8/.dockerignore
new file mode 100644
index 0000000..cb8bc82
--- /dev/null
+++ b/demo/dotnet8/.dockerignore
@@ -0,0 +1,4 @@
+bin/
+obj/
+.git/
+.DS_Store
diff --git a/demo/dotnet8/.gitignore b/demo/dotnet8/.gitignore
new file mode 100644
index 0000000..cd42ee3
--- /dev/null
+++ b/demo/dotnet8/.gitignore
@@ -0,0 +1,2 @@
+bin/
+obj/
diff --git a/demo/dotnet8/Demo.csproj b/demo/dotnet8/Demo.csproj
new file mode 100644
index 0000000..1a0eff8
--- /dev/null
+++ b/demo/dotnet8/Demo.csproj
@@ -0,0 +1,11 @@
+
+
+
+ net8.0
+ enable
+ enable
+ true
+ Demo
+
+
+
diff --git a/demo/dotnet8/Dockerfile b/demo/dotnet8/Dockerfile
new file mode 100644
index 0000000..1024b73
--- /dev/null
+++ b/demo/dotnet8/Dockerfile
@@ -0,0 +1,18 @@
+# 编译阶段:使用编译环境镜像 compile-dotnet8(含 SDK 8.0.403)
+FROM registry.cn-shanghai.aliyuncs.com/odboy/kenaito:compile-dotnet8 AS build
+WORKDIR /src
+COPY Demo.csproj ./
+RUN dotnet restore Demo.csproj
+COPY . ./
+RUN dotnet publish Demo.csproj -c Release -o /app/publish --no-restore
+
+# 运行阶段:使用运行环境镜像 runtime-dotnet8(仅含 ASP.NET Core 运行时 8.0.10)
+FROM registry.cn-shanghai.aliyuncs.com/odboy/kenaito:runtime-dotnet8 AS runtime
+LABEL MAINTAINER="tianjun@odboy.cn"
+ENV TimeZone=Asia/Shanghai
+ENV ASPNETCORE_URLS=http://0.0.0.0:8081
+ENV DOTNET_RUNNING_IN_CONTAINER=true
+WORKDIR /home/admin
+COPY --from=build /app/publish ./
+EXPOSE 8081
+ENTRYPOINT ["dotnet", "Demo.dll"]
diff --git a/demo/dotnet8/Program.cs b/demo/dotnet8/Program.cs
new file mode 100644
index 0000000..f571f55
--- /dev/null
+++ b/demo/dotnet8/Program.cs
@@ -0,0 +1,18 @@
+var builder = WebApplication.CreateBuilder(args);
+
+// 容器内监听 8081,避免与宿主机其它 80 端口冲突;可用环境变量 ASPNETCORE_URLS 覆盖
+builder.WebHost.UseUrls(Environment.GetEnvironmentVariable("ASPNETCORE_URLS") ?? "http://0.0.0.0:8081");
+
+var app = builder.Build();
+
+app.MapGet("/", () => Results.Json(new
+{
+ message = "dotnet8 is running",
+ runtime = Environment.Version.ToString(),
+ os = System.Runtime.InteropServices.RuntimeInformation.OSDescription,
+ time = DateTimeOffset.Now.ToString("yyyy-MM-dd HH:mm:ss zzz")
+}));
+
+app.MapGet("/health", () => Results.Ok("ok"));
+
+app.Run();
diff --git a/demo/dotnet8/README.md b/demo/dotnet8/README.md
new file mode 100644
index 0000000..2d8b750
--- /dev/null
+++ b/demo/dotnet8/README.md
@@ -0,0 +1,78 @@
+# dotnet8 编译 + 运行示例
+
+演示如何用本目录的两个镜像构建一个 .NET 8 Web 应用:
+
+| 阶段 | 镜像 | 说明 |
+| --- |-------------------------------------------------------------|-----------------------------|
+| 编译 | `registry.cn-shanghai.aliyuncs.com/odboy/kenaito:compile-dotnet8` | 含 SDK 8.0.403(见上级 `Dockerfile`) |
+| 运行 | `registry.cn-shanghai.aliyuncs.com/odboy/kenaito:runtime-dotnet8` | 仅含 ASP.NET Core 运行时 8.0.10(见 `image/runtime-dotnet8`) |
+
+编译环境镜像带 SDK 和整套编译工具链(体积大),只在构建阶段使用;运行阶段只拷贝 `dotnet publish` 的产物,
+镜像里不带 SDK、源码和中间文件。
+
+### 示例内容
+
+```
+demo/
+├── Demo.csproj # net8.0 Web 项目
+├── Program.cs # 最小 Web API:GET / 返回运行时信息,GET /health 健康检查
+├── Dockerfile # 两阶段构建:compile-dotnet8 -> runtime-dotnet8
+├── build.sh # 构建镜像(PUSH=1 时同时推送)
+├── docker-compose.yml # 部署编排(端口 8081,固定 IP 172.28.0.20)
+├── startup.sh # docker-compose up -d
+└── shutdown.sh # docker-compose down
+```
+
+### 构建与部署
+
+```shell
+sh build.sh # docker build -t registry.cn-shanghai.aliyuncs.com/odboy/kenaito:demo-dotnet8 .
+PUSH=1 sh build.sh # 构建并推送
+sh startup.sh # docker-compose -f docker-compose.yml -p dotnet8-demo up -d
+```
+
+访问:
+
+```shell
+curl http://127.0.0.1:8081/ # {"message":"dotnet8 is running","runtime":"8.0.10",...}
+curl http://127.0.0.1:8081/health # ok
+```
+
+### 关键点
+
+**还原与发布分离**:先 `COPY` 只有 `*.csproj` 的一层执行 `dotnet restore`,再 `COPY` 源码 `dotnet publish --no-restore`。
+源码改动不会让还原缓存失效,重复构建更快。多项目解决方案可按需增加 `COPY` 的 `*.sln` / `*.csproj` 文件。
+
+**监听地址**:容器内监听 `8081`(`ASPNETCORE_URLS=http://0.0.0.0:8081`),不占用 80 端口,方便与宿主机其它服务共存。
+镜像环境变量、compose 环境变量、部署时 `-e` 三者依次覆盖。
+
+**时区**:镜像已内置 `TimeZone=Asia/Shanghai`,`DateTimeOffset.Now` 输出 +08:00;compose 中再用 `TZ` 显式声明一次。
+
+**入口**:`ENTRYPOINT ["dotnet", "Demo.dll"]`,使用 exec 形式保证 `docker stop` 的 SIGTERM 能传到进程,优雅退出。
+
+**健康检查**:运行镜像自带 `netstat`(`net-tools`),直接用端口探测,不需要额外安装 curl。
+
+### 运维命令
+
+```shell
+docker logs -f dotnet8-demo # 应用日志(stdout/stderr)
+docker exec dotnet8-demo dotnet --info # 确认运行时版本
+docker exec dotnet8-demo sh -c 'ls /home/admin'
+```
+
+### 调试时直接在编译镜像里运行
+
+需要看编译报错或临时跑一下时,可以只挂载源码进编译镜像(不需要构建镜像):
+
+```shell
+docker run --rm -it -p 8081:8081 \
+ -v "$PWD":/src -w /src \
+ registry.cn-shanghai.aliyuncs.com/odboy/kenaito:compile-dotnet8 \
+ dotnet run
+```
+
+### 停止
+
+```shell
+sh shutdown.sh
+```
diff --git a/demo/dotnet8/build.sh b/demo/dotnet8/build.sh
new file mode 100755
index 0000000..67123f5
--- /dev/null
+++ b/demo/dotnet8/build.sh
@@ -0,0 +1,11 @@
+#!/usr/bin/env bash
+# 在示例目录下构建示例镜像(编译 + 运行两阶段均在本机 docker 内完成)
+set -euo pipefail
+cd "$(dirname "$0")"
+
+IMAGE=${IMAGE:-registry.cn-shanghai.aliyuncs.com/odboy/kenaito:demo-dotnet8}
+docker build -t "${IMAGE}" .
+
+if [ "${PUSH:-0}" = "1" ]; then
+ docker push "${IMAGE}"
+fi
diff --git a/demo/dotnet8/docker-compose.yml b/demo/dotnet8/docker-compose.yml
new file mode 100644
index 0000000..662ce17
--- /dev/null
+++ b/demo/dotnet8/docker-compose.yml
@@ -0,0 +1,28 @@
+version: '3.8'
+
+networks:
+ dotnet8-demo:
+ ipam:
+ driver: default
+ config:
+ - subnet: "172.28.0.0/24"
+
+services:
+ demo:
+ image: registry.cn-shanghai.aliyuncs.com/odboy/kenaito:demo-dotnet8 # 镜像由 build.sh 构建
+ container_name: dotnet8-demo
+ restart: unless-stopped
+ ports: # 映射端口
+ - "8081:8081"
+ environment: # 设置环境变量,相当于docker run命令中的-e
+ TZ: Asia/Shanghai
+ ASPNETCORE_URLS: http://0.0.0.0:8081
+ healthcheck:
+ test: ["CMD-SHELL", "netstat -tln | grep -q ':8081 '"]
+ interval: 30s
+ timeout: 5s
+ retries: 3
+ start_period: 5s
+ networks:
+ dotnet8-demo:
+ ipv4_address: 172.28.0.20
diff --git a/demo/dotnet8/shutdown.sh b/demo/dotnet8/shutdown.sh
new file mode 100755
index 0000000..3643b98
--- /dev/null
+++ b/demo/dotnet8/shutdown.sh
@@ -0,0 +1,4 @@
+#!/usr/bin/env bash
+set -euo pipefail
+cd "$(dirname "$0")"
+docker-compose -f docker-compose.yml -p dotnet8-demo down
diff --git a/demo/dotnet8/startup.sh b/demo/dotnet8/startup.sh
new file mode 100755
index 0000000..069b03b
--- /dev/null
+++ b/demo/dotnet8/startup.sh
@@ -0,0 +1,4 @@
+#!/usr/bin/env bash
+set -euo pipefail
+cd "$(dirname "$0")"
+docker-compose -f docker-compose.yml -p dotnet8-demo up -d
diff --git a/demo/dotnet9/.dockerignore b/demo/dotnet9/.dockerignore
new file mode 100644
index 0000000..cb8bc82
--- /dev/null
+++ b/demo/dotnet9/.dockerignore
@@ -0,0 +1,4 @@
+bin/
+obj/
+.git/
+.DS_Store
diff --git a/demo/dotnet9/.gitignore b/demo/dotnet9/.gitignore
new file mode 100644
index 0000000..cd42ee3
--- /dev/null
+++ b/demo/dotnet9/.gitignore
@@ -0,0 +1,2 @@
+bin/
+obj/
diff --git a/demo/dotnet9/Demo.csproj b/demo/dotnet9/Demo.csproj
new file mode 100644
index 0000000..c209c23
--- /dev/null
+++ b/demo/dotnet9/Demo.csproj
@@ -0,0 +1,11 @@
+
+
+
+ net9.0
+ enable
+ enable
+ true
+ Demo
+
+
+
diff --git a/demo/dotnet9/Dockerfile b/demo/dotnet9/Dockerfile
new file mode 100644
index 0000000..feab195
--- /dev/null
+++ b/demo/dotnet9/Dockerfile
@@ -0,0 +1,18 @@
+# 编译阶段:使用编译环境镜像 compile-dotnet9(含 SDK 9.0.100-rc.2.24474.11)
+FROM registry.cn-shanghai.aliyuncs.com/odboy/kenaito:compile-dotnet9 AS build
+WORKDIR /src
+COPY Demo.csproj ./
+RUN dotnet restore Demo.csproj
+COPY . ./
+RUN dotnet publish Demo.csproj -c Release -o /app/publish --no-restore
+
+# 运行阶段:使用运行环境镜像 runtime-dotnet9(仅含 ASP.NET Core 运行时 9.0.0-rc.2.24474.3)
+FROM registry.cn-shanghai.aliyuncs.com/odboy/kenaito:runtime-dotnet9 AS runtime
+LABEL MAINTAINER="tianjun@odboy.cn"
+ENV TimeZone=Asia/Shanghai
+ENV ASPNETCORE_URLS=http://0.0.0.0:8082
+ENV DOTNET_RUNNING_IN_CONTAINER=true
+WORKDIR /home/admin
+COPY --from=build /app/publish ./
+EXPOSE 8082
+ENTRYPOINT ["dotnet", "Demo.dll"]
diff --git a/demo/dotnet9/Program.cs b/demo/dotnet9/Program.cs
new file mode 100644
index 0000000..9c1686a
--- /dev/null
+++ b/demo/dotnet9/Program.cs
@@ -0,0 +1,18 @@
+var builder = WebApplication.CreateBuilder(args);
+
+// 容器内监听 8082,避免与宿主机其它 80 端口冲突;可用环境变量 ASPNETCORE_URLS 覆盖
+builder.WebHost.UseUrls(Environment.GetEnvironmentVariable("ASPNETCORE_URLS") ?? "http://0.0.0.0:8082");
+
+var app = builder.Build();
+
+app.MapGet("/", () => Results.Json(new
+{
+ message = "dotnet9 is running",
+ runtime = Environment.Version.ToString(),
+ os = System.Runtime.InteropServices.RuntimeInformation.OSDescription,
+ time = DateTimeOffset.Now.ToString("yyyy-MM-dd HH:mm:ss zzz")
+}));
+
+app.MapGet("/health", () => Results.Ok("ok"));
+
+app.Run();
diff --git a/demo/dotnet9/README.md b/demo/dotnet9/README.md
new file mode 100644
index 0000000..5800fa1
--- /dev/null
+++ b/demo/dotnet9/README.md
@@ -0,0 +1,78 @@
+# dotnet9 编译 + 运行示例
+
+演示如何用本目录的两个镜像构建一个 .NET 9 Web 应用:
+
+| 阶段 | 镜像 | 说明 |
+| --- |-------------------------------------------------------------|-----------------------------|
+| 编译 | `registry.cn-shanghai.aliyuncs.com/odboy/kenaito:compile-dotnet9` | 含 SDK 9.0.100-rc.2.24474.11(见上级 `Dockerfile`) |
+| 运行 | `registry.cn-shanghai.aliyuncs.com/odboy/kenaito:runtime-dotnet9` | 仅含 ASP.NET Core 运行时 9.0.0-rc.2.24474.3(见 `image/runtime-dotnet9`) |
+
+编译环境镜像带 SDK 和整套编译工具链(体积大),只在构建阶段使用;运行阶段只拷贝 `dotnet publish` 的产物,
+镜像里不带 SDK、源码和中间文件。
+
+### 示例内容
+
+```
+demo/
+├── Demo.csproj # net9.0 Web 项目
+├── Program.cs # 最小 Web API:GET / 返回运行时信息,GET /health 健康检查
+├── Dockerfile # 两阶段构建:compile-dotnet9 -> runtime-dotnet9
+├── build.sh # 构建镜像(PUSH=1 时同时推送)
+├── docker-compose.yml # 部署编排(端口 8082,固定 IP 172.29.0.20)
+├── startup.sh # docker-compose up -d
+└── shutdown.sh # docker-compose down
+```
+
+### 构建与部署
+
+```shell
+sh build.sh # docker build -t registry.cn-shanghai.aliyuncs.com/odboy/kenaito:demo-dotnet9 .
+PUSH=1 sh build.sh # 构建并推送
+sh startup.sh # docker-compose -f docker-compose.yml -p dotnet9-demo up -d
+```
+
+访问:
+
+```shell
+curl http://127.0.0.1:8082/ # {"message":"dotnet9 is running","runtime":"9.0.0-rc.2.24474.3",...}
+curl http://127.0.0.1:8082/health # ok
+```
+
+### 关键点
+
+**还原与发布分离**:先 `COPY` 只有 `*.csproj` 的一层执行 `dotnet restore`,再 `COPY` 源码 `dotnet publish --no-restore`。
+源码改动不会让还原缓存失效,重复构建更快。多项目解决方案可按需增加 `COPY` 的 `*.sln` / `*.csproj` 文件。
+
+**监听地址**:容器内监听 `8082`(`ASPNETCORE_URLS=http://0.0.0.0:8082`),不占用 80 端口,方便与宿主机其它服务共存。
+镜像环境变量、compose 环境变量、部署时 `-e` 三者依次覆盖。
+
+**时区**:镜像已内置 `TimeZone=Asia/Shanghai`,`DateTimeOffset.Now` 输出 +08:00;compose 中再用 `TZ` 显式声明一次。
+
+**入口**:`ENTRYPOINT ["dotnet", "Demo.dll"]`,使用 exec 形式保证 `docker stop` 的 SIGTERM 能传到进程,优雅退出。
+
+**健康检查**:运行镜像自带 `netstat`(`net-tools`),直接用端口探测,不需要额外安装 curl。
+
+### 运维命令
+
+```shell
+docker logs -f dotnet9-demo # 应用日志(stdout/stderr)
+docker exec dotnet9-demo dotnet --info # 确认运行时版本
+docker exec dotnet9-demo sh -c 'ls /home/admin'
+```
+
+### 调试时直接在编译镜像里运行
+
+需要看编译报错或临时跑一下时,可以只挂载源码进编译镜像(不需要构建镜像):
+
+```shell
+docker run --rm -it -p 8082:8082 \
+ -v "$PWD":/src -w /src \
+ registry.cn-shanghai.aliyuncs.com/odboy/kenaito:compile-dotnet9 \
+ dotnet run
+```
+
+### 停止
+
+```shell
+sh shutdown.sh
+```
diff --git a/demo/dotnet9/build.sh b/demo/dotnet9/build.sh
new file mode 100755
index 0000000..64b3aca
--- /dev/null
+++ b/demo/dotnet9/build.sh
@@ -0,0 +1,11 @@
+#!/usr/bin/env bash
+# 在示例目录下构建示例镜像(编译 + 运行两阶段均在本机 docker 内完成)
+set -euo pipefail
+cd "$(dirname "$0")"
+
+IMAGE=${IMAGE:-registry.cn-shanghai.aliyuncs.com/odboy/kenaito:demo-dotnet9}
+docker build -t "${IMAGE}" .
+
+if [ "${PUSH:-0}" = "1" ]; then
+ docker push "${IMAGE}"
+fi
diff --git a/demo/dotnet9/docker-compose.yml b/demo/dotnet9/docker-compose.yml
new file mode 100644
index 0000000..566dd04
--- /dev/null
+++ b/demo/dotnet9/docker-compose.yml
@@ -0,0 +1,28 @@
+version: '3.8'
+
+networks:
+ dotnet9-demo:
+ ipam:
+ driver: default
+ config:
+ - subnet: "172.29.0.0/24"
+
+services:
+ demo:
+ image: registry.cn-shanghai.aliyuncs.com/odboy/kenaito:demo-dotnet9 # 镜像由 build.sh 构建
+ container_name: dotnet9-demo
+ restart: unless-stopped
+ ports: # 映射端口
+ - "8082:8082"
+ environment: # 设置环境变量,相当于docker run命令中的-e
+ TZ: Asia/Shanghai
+ ASPNETCORE_URLS: http://0.0.0.0:8082
+ healthcheck:
+ test: ["CMD-SHELL", "netstat -tln | grep -q ':8082 '"]
+ interval: 30s
+ timeout: 5s
+ retries: 3
+ start_period: 5s
+ networks:
+ dotnet9-demo:
+ ipv4_address: 172.29.0.20
diff --git a/demo/dotnet9/shutdown.sh b/demo/dotnet9/shutdown.sh
new file mode 100755
index 0000000..316d5e6
--- /dev/null
+++ b/demo/dotnet9/shutdown.sh
@@ -0,0 +1,4 @@
+#!/usr/bin/env bash
+set -euo pipefail
+cd "$(dirname "$0")"
+docker-compose -f docker-compose.yml -p dotnet9-demo down
diff --git a/demo/dotnet9/startup.sh b/demo/dotnet9/startup.sh
new file mode 100755
index 0000000..ffffc7e
--- /dev/null
+++ b/demo/dotnet9/startup.sh
@@ -0,0 +1,4 @@
+#!/usr/bin/env bash
+set -euo pipefail
+cd "$(dirname "$0")"
+docker-compose -f docker-compose.yml -p dotnet9-demo up -d