DEV Community: DD

NetCore中Singleton、Transient、Scoped举例分析三种模式的区别

DD — Tue, 26 May 2026 13:49:17 +0000

在 ASP.NET Core 的依赖注入（Dependency Injection, DI）容器中，Singleton、Transient 和 Scoped 是三种核心生命周期管理方式，用来控制服务实例的创建与共享规则。

理解这三种模式，是掌握 ASP.NET Core 架构设计的关键基础。

一、代码示例

下面用一个简单的示例来说明它们之间的区别：

1. 控制器调用

    [ApiController]
    [Route("api/[controller]")]
    public class TestController : ControllerBase
    {
        private readonly IServiceProvider _serviceProvider;

        public TestController(IServiceProvider serviceProvider)
        {
            _serviceProvider = serviceProvider;
        }

        [HttpGet]
        public IActionResult Get()
        {
            Console.WriteLine("======= 收到 API 请求 =======");
            var my1 = _serviceProvider.GetService<IMyService>();
            var my2 = _serviceProvider.GetService<IMyService>();

            my1.DoSomething();
            my2.DoSomething();

            Console.WriteLine("======= 结束 API 请求 =======\n\n");

            return Ok();
        }
    }

2. 服务定义

    public interface IMyService
    {
        void DoSomething();
    }

    public class MyService : IMyService
    {
        private readonly string _instanceId;

        public MyService()
        {
            _instanceId = Random.Shared.Next(100, 999).ToString();
            Console.WriteLine($"[MyService-构造函数] 实例 Id 为: {_instanceId}");
        }

        public void DoSomething()
        {
            Console.WriteLine($"[MyService-方法调用] 实例 Id 为: {_instanceId}");
        }
    }

3. 注册方式

// 使用 Singleton 生命周期的示例
builder.Services.AddSingleton<IMyService, MyService>();

// 使用 Scoped 生命周期的示例
builder.Services.AddScoped<IMyService, MyService>();

// 使用 Transient 生命周期的示例
builder.Services.AddTransient<IMyService, MyService>();

二、运行结果

现在，我们来看看它们在不同的场景中的行为：

1. Singleton（单例）

//**********第一次调用API**********
======= 收到 API 请求 =======
[MyService-构造函数] 实例 Id 为: 178
[MyService-方法调用] 实例 Id 为: 178
[MyService-方法调用] 实例 Id 为: 178
======= 结束 API 请求 =======

//**********第二次调用API**********
======= 收到 API 请求 =======
[MyService-方法调用] 实例 Id 为: 178
[MyService-方法调用] 实例 Id 为: 178
======= 结束 API 请求 =======

//**********第三次调用API**********
======= 收到 API 请求 =======
[MyService-方法调用] 实例 Id 为: 178
[MyService-方法调用] 实例 Id 为: 178
======= 结束 API 请求 =======

全局只创建一个实例
整个应用程序生命周期内共享
所有请求都使用同一个对象

👉 特点：全局唯一

2. Scoped （作用域）

//**********第一次调用API**********
======= 收到 API 请求 =======
[MyService-构造函数] 实例 Id 为: 438
[MyService-方法调用] 实例 Id 为: 438
[MyService-方法调用] 实例 Id 为: 438
======= 结束 API 请求 =======

//**********第二次调用API**********
======= 收到 API 请求 =======
[MyService-构造函数] 实例 Id 为: 674
[MyService-方法调用] 实例 Id 为: 674
[MyService-方法调用] 实例 Id 为: 674
======= 结束 API 请求 =======

//**********第三次调用API**********
======= 收到 API 请求 =======
[MyService-构造函数] 实例 Id 为: 365
[MyService-方法调用] 实例 Id 为: 365
[MyService-方法调用] 实例 Id 为: 365
======= 结束 API 请求 =======

在同一个请求（Scope）内共享一个实例
不同请求之间是不同实例
常见于 Web API 请求生命周期

👉 特点：请求内单例，请求间隔离

3.Transient（瞬态）

//**********第一次调用API**********
======= 收到 API 请求 =======
[MyService-构造函数] 实例 Id 为: 794
[MyService-方法调用] 实例 Id 为: 794
[MyService-构造函数] 实例 Id 为: 182
[MyService-方法调用] 实例 Id 为: 182
======= 结束 API 请求 =======

//**********第二次调用API**********
======= 收到 API 请求 =======
[MyService-构造函数] 实例 Id 为: 436
[MyService-方法调用] 实例 Id 为: 436
[MyService-构造函数] 实例 Id 为: 588
[MyService-方法调用] 实例 Id 为: 588
======= 结束 API 请求 =======

//**********第三次调用API**********
======= 收到 API 请求 =======
[MyService-构造函数] 实例 Id 为: 391
[MyService-方法调用] 实例 Id 为: 391
[MyService-构造函数] 实例 Id 为: 182
[MyService-方法调用] 实例 Id 为: 182
======= 结束 API 请求 =======

每次请求都会创建一个新实例
每次解析（Resolve）都会生成新的对象
不共享状态

👉 特点：用完即弃，每次都是新的

三、区别总结

生命周期	创建次数	是否共享	适用场景
Singleton	全局一次	全局共享	配置、缓存、日志
Scoped	每个请求一次	请求内共享	DB上下文、业务服务
Transient	每次解析一次	不共享	无状态工具类

四、使用建议

✔ 推荐使用方式

默认优先：Scoped
无状态工具：Transient
全局共享且线程安全：Singleton

⚠️ 常见坑

❌ 在 Singleton 中注入 Scoped（容易导致作用域失效）
❌ Singleton 持有可变状态（线程安全风险）
❌ 过度使用 Transient（性能浪费）

五、总结理解

Singleton：整个应用只有一个
Scoped：每个请求一个
Transient：每次用都是新的

通过 OpenResty+ MinIO + weserv/images 搭建自己的阿里云OSS

DD — Tue, 26 May 2026 13:46:43 +0000

下面是一套可操作的方案，基于 OpenResty + MinIO + weserv/images 搭建一个可自托管、支持图片处理能力的“类阿里云 OSS” 服务。整体目标是：

MinIO 作为对象存储（兼容 S3 API）
OpenResty 提供反向代理、鉴权、图片处理网关
weserv/images 提供图片缩放、裁剪、格式转换等能力（类似阿里云 OSS 图片处理）

1. 安装 MinIO

docker run -d --name minio \
  -p 9000:9000 -p 9001:9001 \
  -e "MINIO_ROOT_USER=admin" \
  -e "MINIO_ROOT_PASSWORD=admin123" \
  minio/minio server /data --console-address ":9001"

访问 MinIO 控制台：

管理后台：http://localhost:9001
S3 接口：http://localhost:9000

2. 安装 weserv/images（图片处理服务）

weserv/images 本质是一个支持 URL 参数的图片处理服务器。

创建 Dockerfile 文件

FROM ghcr.io/weserv/images:5.x

RUN sed -i '/weserv_deny_ip/d' /etc/nginx/nginx.conf

构建并运行

docker build -t weserv/images .
docker run -d -p 8080:80 --shm-size=1gb --name=weserv weserv/images

示例处理 URL：

http://localhost:8080?url=https://example.com/a.jpg&w=200&h=200

3. 安装 OpenResty

docker run -d --name openresty \
  -p 80:80 \
  -v /opt/openresty/conf/nginx.conf:/usr/local/openresty/nginx/conf/nginx.conf \
  openresty/openresty:latest

4. 配置 OpenResty 作为代理（核心 OSS 功能）

编辑文件：/opt/openresty/conf/nginx.conf

server {
    listen 80;
    server_name img.example.com;# minio

    # 图片处理
    location ~* \.(jpg|jpeg|png|gif|webp)$ {

        set $upstream "";
        rewrite_by_lua_block {
            local args = ngx.req.get_uri_args()
            local process = args["x-image-process"]
            if not process then         
                -- 没有 x-image-process 参数，直接代理到 minio
                ngx.var.upstream = "http://127.0.0.1:9000" .. ngx.var.uri               
            else
                -- 有 x-image-process 参数，直接代理到 weserv/images
                local new_query = process:gsub("_", "="):gsub(",", "&")               
                ngx.var.upstream = "http://127.0.0.1:8080/?url=127.0.0.1:9000" .. ngx.var.uri .. "&" .. new_query                
            end
        }
        proxy_pass $upstream;
    }

      # 其他资源
    location / {
        proxy_pass   http://127.0.0.1:9000;        
    }
}

重启 OpenResty：

docker restart openresty

5. 测试访问

① 原图访问（MinIO）
http://img.example.com/path/to/img.jpg

② 缩略图（weserv/images）
http://img.example.com/path/to/img.jpg?x-image-process=w_100

内部转发到weserv/images处理
http://127.0.0.1:8080/?url=img.example.com/path/to/img.jpg&w=100

等同 OSS 的：
?x-oss-process=image/resize,w_100

Deploying weserv/images with Docker

DD — Fri, 28 Nov 2025 07:19:29 +0000

Dockerfile

For self-hosted instances, you can remove those weserv_deny_ip nginx directives from your nginx.conf.

FROM ghcr.io/weserv/images:5.x

RUN sed -i '/weserv_deny_ip/d' /etc/nginx/nginx.conf

Usage

docker build -t weserv/images .
docker run -d -p 8080:80 --shm-size=1gb --name=weserv weserv/images

Links

Website: https://wsrv.nl/

Github: https://github.com/weserv/images

Docker: https://github.com/weserv/images/tree/5.x/docker#readme

Fix for “IP address blocked by policy” issue: https://github.com/weserv/images/issues/440

How to Install the Nextcloud All-in-One on Linux

DD — Wed, 15 Oct 2025 06:51:55 +0000

Run Nextcloud AIO

sudo docker run -d \
--init \
--sig-proxy=false \
--name nextcloud-aio-mastercontainer \
--restart always \
--publish 8090:8080 \
--env APACHE_PORT=11000 \
--env APACHE_IP_BINDING=0.0.0.0 \
--env APACHE_ADDITIONAL_NETWORK="" \
--env SKIP_DOMAIN_VALIDATION=false \
--volume nextcloud_aio_mastercontainer:/mnt/docker-aio-config \
--volume /var/run/docker.sock:/var/run/docker.sock:ro \
--env NEXTCLOUD_DATADIR="/mnt/ncdata" \
ghcr.io/nextcloud-releases/all-in-one:latest

All-in-One setup

About Collabora

When opening the document, an error may occur:
Failed to establish socket connection or socket connection closed unexpectedly. The reverse proxy might be misconfigured, please contact the administrator. For more info on proxy configuration please checkout https://sdk.collaboraonline.com/docs/installation/Proxy_settings.html

server {
 listen       443 ssl;
 server_name  cloud.example.com;


 ssl_certificate /path/to/certificate;
 ssl_certificate_key /path/to/key;

 # Nextcloud Web Serve
 location / {
   root    /;
   proxy_set_header Host $host;
   proxy_set_header X-Real-IP $remote_addr;
   proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
   proxy_set_header X-Forwarded-Proto $scheme;
   proxy_read_timeout 90;
   proxy_pass   http://192.168.168.10:11000/;
 }

 # static files
 location ^~ /browser {
   proxy_pass http://127.0.0.1:11000;
   proxy_set_header Host $host;
 }


 # WOPI discovery URL
 location ^~ /hosting/discovery {
   proxy_pass http://127.0.0.1:11000;
   proxy_set_header Host $host;
 }


 # Capabilities
 location ^~ /hosting/capabilities {
   proxy_pass http://127.0.0.1:11000;
   proxy_set_header Host $host;
 }


 # main websocket
 location ~ ^/cool/(.*)/ws$ {
   proxy_pass http://127.0.0.1:11000;
   proxy_set_header Upgrade $http_upgrade;
   proxy_set_header Connection "Upgrade";
   proxy_set_header Host $host;
   proxy_read_timeout 36000s;
 }


 # download, presentation and image upload
 location ~ ^/(c|l)ool {
   proxy_pass http://127.0.0.1:11000;
   proxy_set_header Host $host;
 }


 # Admin Console websocket
 location ^~ /cool/adminws {
   proxy_pass http://127.0.0.1:11000;
   proxy_set_header Upgrade $http_upgrade;
   proxy_set_header Connection "Upgrade";
   proxy_set_header Host $host;
   proxy_read_timeout 36000s;
 }
}

About OnlyOffice

docker run -i -t -d -p 7070:80 \
  -e JWT_ENABLED=true \
  -e JWT_SECRET=your_jwt_secret \
  --name onlyoffice-documentserver \
  onlyoffice/documentserver:9.0.4.1

How to setup OnlyOffice?
https://github.com/nextcloud/all-in-one/discussions/5302

ONLYOFFICE/Docker-DocumentServer
https://github.com/ONLYOFFICE/Docker-DocumentServer

Useful links

How to Install the Nextcloud All-in-One on Linux
https://nextcloud.com/blog/how-to-install-the-nextcloud-all-in-one-on-linux/

Reverse Proxy Documentation
https://github.com/nextcloud/all-in-one/blob/main/reverse-proxy.md

all-in-one/compose.yaml
https://github.com/nextcloud/all-in-one/blob/main/compose.yaml

ESXi 虚拟机安装CentOS 8

DD — Wed, 27 Aug 2025 02:44:20 +0000

添加CentOS虚拟机

1. 选择创建类型

2. 选择名称和客户机操作系统

3. 选择存储

4. 自定义设置

虚拟硬件

虚拟机选项

5.即将完成

安装CentOS流程

根密码

记住勾选：允许root用户使用密码进行SSH登录

网络和主机名

安装目的地

软件选择

开始安装

在Ubuntu上安装OpenVPN客户端

DD — Thu, 17 Jul 2025 08:30:38 +0000

在 Linux 上配置 OpenVPN 客户端，通过 OpenVPN 连接到公司、服务器局域网。

安装 OpenVPN 客户端

sudo apt-get update
sudo apt-get install openvpn

启动OpenVPN客户端

使用以下命令启动OpenVPN客户端，并指定配置文件：

sudo openvpn --config /etc/openvpn/client.ovpn

如果提示：Enter Private Key Password，输入指定密码即可。

测试命令

ping google.com
ping baidu.com

在 CentOS 上安装 OpenVPN 客户端连接配置

DD — Thu, 17 Jul 2025 08:30:10 +0000

在 Linux 上配置 OpenVPN 客户端，通过 OpenVPN 连接到公司、服务器局域网。

安装 OpenVPN 客户端

yum 直接安装

yum -y install epel-release
yum -y install openvpn

安装完成后会在 /etc/openvpn 生成对应的文件

[root@localhost /]# cd /etc/openvpn/
[root@localhost openvpn]# ls
client  server

配置文件

导入客户端配置（通常是 .ovpn 文件）和账号密码文件

[root@localhost openvpn]# tree /etc/openvpn/
/etc/openvpn/
├── client
├── client.ovpn           # 客户端配置文件
├── passwd                # 账号密码文件
└── server

2 directories, 2 files

连接测试

执行命令

openvpn \
--daemon \
--cd /etc/openvpn \
--config client.ovpn \
--askpass /etc/openvpn/passwd \
--log-append /var/log/openvpn.log

命令参数说明

--daemon           # 后台运行
--cd               # 配置文件目录路径
--config           # 配置文件名称
--askpass          # 指定账号密码文件
--log-append       # 日志文件

测试命令

ping google.com

参考文档
Linux OpenVPN 客户端连接配置
 [Solved] Please enter password with the systemd-tty-ask-password-agent tool!