讲师中心 微信公众号
AI工具推荐 视频效率加速

C#怎么获取当前程序占用的端口号_C#如何读取自身监听端口【方法】

胖静同学_9904

胖静同学_9904

发布时间:2026-03-19 14:33:17

|

791人浏览过

|

来源于php中文网

原创

应从监听对象自身获取端口:TcpListener用LocalEndpoint.Port,HttpListener解析Prefix.Uri.Port,Kestrel应在启动前读取配置值;避免依赖系统级API如GetActiveTcpListeners()。

c#怎么获取当前程序占用的端口号_c#如何读取自身监听端口【方法】

怎么查自己程序监听了哪个端口(C# 进程内)

不能直接“读取自身监听端口”,因为 .NET 没提供 GetCurrentListeningPort() 这种函数——端口是绑定时指定的,不是运行时自动注册的全局属性。你得从自己创建的监听对象里反查。

常见场景:用 TcpListener、HttpListener 或 ASP.NET Core 的 Kestrel 启动服务后,想在日志里打印“已监听 http://localhost:5001”。关键不是“查系统”,而是“别丢掉你亲手传进去的那个端口号”。

  • 用 TcpListener 时,端口是你构造时传入的:new TcpListener(IPAddress.Any, 8080) → 端口就是 8080
  • 用 HttpListener 时,Prefix 里带端口,比如 http://+:8080/ → 解析 Uri 就能拿到 8080
  • ASP.NET Core 中,端口来自配置(appsettings.json 或命令行),实际监听对象(KestrelServer)不暴露端口属性;推荐在启动前就记录配置值,而不是事后去挖

为什么 GetActiveTcpConnections() 查不到自己的端口?

调用 IPGlobalProperties.GetActiveTcpListeners() 确实能列出本机所有监听端口,但结果是进程无关的——它返回的是 IPEndPoint 列表,不含 PID。你无法确认某个 :5000 是你的程序还是另一个 dotnet 进程开的。

更麻烦的是权限和兼容性:GetActiveTcpListeners() 在 Linux/macOS 上不可用(.NET 6+ 跨平台 API 不支持),Windows 上还需管理员权限才能看到其他用户的监听项。

C#
C#

"避开 C# 常见错误——空陷阱、异步陷阱、LINQ 陷阱及资源泄漏。"

下载
  • 非管理员运行时,可能只返回 127.0.0.1:xxx,漏掉 0.0.0.0:xxx
  • 多个服务监听同一端口(如 SO_REUSE_PORT)时,结果不可靠
  • 容器或 Docker 环境中,端口映射(host:8080 → container:5000)会让系统级查询完全失真

HttpListener 和 Kestrel 的端口获取差异

HttpListener 是旧式 API,端口明文写在 Prefix 里,解析简单;Kestrel 是 ASP.NET Core 默认服务器,端口由配置驱动,运行时不可变但也不直接暴露。

  • HttpListener 示例:
    var listener = new HttpListener();
    listener.Prefixes.Add("http://+:3000/");
    listener.Start();
    int port = new Uri(listener.Prefixes[0]).Port; // → 3000
  • Kestrel 不建议运行时查:它可能绑定多个地址(http://*:5000, https://*:5001),也可能被反向代理接管(此时真实监听端口对应用无意义)。正确做法是在 Program.cs 读配置:builder.Configuration.GetValue<int>("Kestrel:Endpoints:Http:Port", 5000)</int>
  • 若强行反射获取 KestrelServer 内部端口,会因版本升级失效(内部字段名常变),且跨平台行为不一致

最容易被忽略的复杂点:动态端口(0)和 IPv6

当你把端口设为 0(让系统自动分配),就不能再“读取”原始端口值了——必须从监听成功后的 LocalEndpoint 反查。而且这个动作必须在 Start() 之后、Accept() 之前做,否则可能还没真正绑定。

IPv6 下更易踩坑:IPAddress.Any 在双栈系统上可能同时监听 IPv4 和 IPv6,但 LocalEndpoint 返回的可能是 :::5000,而你预期的是 0.0.0.0:5000。不要硬编码字符串解析。

  • 安全做法:
    var listener = new TcpListener(IPAddress.Any, 0);
    listener.Start();
    int actualPort = ((IPEndPoint)listener.LocalEndpoint).Port;
  • 避免用 ToString() 解析地址,改用 .Port 属性
  • 日志中写端口时,加上协议和地址上下文,比如 “HTTP listening on http://[::]:5000”

端口不是藏在系统里的秘密,是你代码里写死、配死、或者显式申请的。盯着监听对象本身,比扫描全系统更准、更快、更稳。

热门AI工具

更多
蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

超级麦吉

一款通过数字员工协作完成调研、数据分析与文档制作的AI办公平台。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

小橡皮AI

一款AI工具,主要用于小橡皮一键去AI味,将机器味重的内容改得更有活人感,防止因为 AI 内容被平台打上 AI 标签,以及限流,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

相关专题

更多
c#是什么意思
c#是什么意思

C#是一种通用的面向对象编程语言,它在.NET框架上运行,可用于开发各种类型的应用程序。本专题为大家提供c#相关的各种文章、以及下载和课程。

1072

2023.08.08

什么是c#
什么是c#

C#(读作C Sharp)是一种现代的、通用的、面向对象的编程语言。它由微软公司开发,于2000年首次发布,主要用于开发Windows桌面应用程序、Web应用程序、移动应用程序以及游戏开发等领域。C#是一种类型安全和托管的编程语言,它结合了C++的强大性能和C语言的简单易学特点,并引入了许多新的特性和概念,如委托、属性、泛型和异步编程等,以提高开发效率和代码可维护性。

3131

2023.08.31

C#中base关键字的用法
C#中base关键字的用法

在C#中,base关键字用于访问当前类的基类成员,这包括基类的字段、属性、方法、构造函数、索引器以及事件。想了解更多C#的相关内容,可以阅读本专题下面的文章。

905

2024.03.13

C#Task用法
C#Task用法

Task在C#中是用于表示异步操作的对象,它位于System.Threading.Tasks命名空间中。想了解更多C#中各种用法的相关内容,可以阅读本专题下面的文章。

2655

2024.03.14

C# 并发与异步编程
C# 并发与异步编程

本专题系统讲解 C# 异步编程与并发控制,重点介绍 async 和 await 关键字、Task 类、线程池管理、并发数据结构、死锁与线程安全问题。通过多个实战项目,帮助学习者掌握 如何在 C# 中编写高效的异步代码,提升应用的并发性能与响应速度。

332

2026.02.03

C# 多线程与异步编程
C# 多线程与异步编程

本专题深入讲解 C# 中多线程与异步编程的核心概念与实战技巧,包括线程池管理、Task 类的使用、async/await 异步编程模式、并发控制与线程同步、死锁与竞态条件的解决方案。通过实际项目,帮助开发者掌握 如何在 C# 中构建高并发、低延迟的异步系统,提升应用性能和响应速度。

429

2026.02.06

C# ASP.NET Core微服务架构与API网关实践
C# ASP.NET Core微服务架构与API网关实践

本专题围绕 C# 在现代后端架构中的微服务实践展开,系统讲解基于 ASP.NET Core 构建可扩展服务体系的核心方法。内容涵盖服务拆分策略、RESTful API 设计、服务间通信、API 网关统一入口管理以及服务治理机制。通过真实项目案例,帮助开发者掌握构建高可用微服务系统的关键技术,提高系统的可扩展性与维护效率。

631

2026.03.11

C# Unity游戏开发与ECS架构实践
C# Unity游戏开发与ECS架构实践

本专题聚焦 C# 在 Unity 游戏开发中的应用,系统讲解 ECS(Entity-Component-System)架构设计、游戏对象管理、性能优化与内存控制策略。通过实际游戏案例,帮助开发者构建高性能、结构清晰的游戏系统,提高游戏开发效率与运行性能。

329

2026.04.13

Vite 项目如何打包和部署
Vite 项目如何打包和部署

Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章,帮助读者完成上线流程。

40

2026.10.28

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
C++ Core Guidelines
C++ Core Guidelines

共0课时 | 0人学习

C++ Reference
C++ Reference

共0课时 | 0人学习

C++ 官方标准说明
C++ 官方标准说明

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn