0

0

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

冰火之心

冰火之心

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

|

731人浏览过

|

来源于php中文网

原创

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

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

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

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

常见场景:用 TcpListenerHttpListener 或 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 上还需管理员权限才能看到其他用户的监听项。

  • 非管理员运行时,可能只返回 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)
  • 若强行反射获取 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工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

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

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

279

2023.08.08

什么是c#
什么是c#

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

185

2023.08.31

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

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

327

2024.03.13

C#Task用法
C#Task用法

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

380

2024.03.14

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

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

29

2026.02.03

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

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

108

2026.02.06

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

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

416

2026.03.11

Python 多线程与异步编程实战
Python 多线程与异步编程实战

本专题系统讲解 Python 多线程与异步编程的核心概念与实战技巧,包括 threading 模块基础、线程同步机制、GIL 原理、asyncio 异步任务管理、协程与事件循环、任务调度与异常处理。通过实战示例,帮助学习者掌握 如何构建高性能、多任务并发的 Python 应用。

381

2025.12.24

Go Web框架Gin接口开发与中间件设计实践
Go Web框架Gin接口开发与中间件设计实践

本专题围绕 Go 在 Web 后端开发中的主流框架 Gin 展开,系统讲解高性能接口开发与中间件机制设计。内容涵盖路由分组、请求绑定、参数校验、统一响应封装、日志与鉴权中间件实现,以及接口限流与异常处理策略。通过实战项目案例,帮助开发者构建结构清晰、性能优良的 Go Web 服务体系,提升接口开发效率与系统可维护性。

7

2026.03.19

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
C# 教程
C# 教程

共94课时 | 11.6万人学习

C 教程
C 教程

共75课时 | 5.6万人学习

C++教程
C++教程

共115课时 | 22.5万人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号