在日常使用 懒猫微服（LazyCat Micro-Service） 的过程中，我们习惯于使用域名访问。如果你经常使用其他 NAS，就会问这个问题：如何知道一台机器在局域网里的私有地址？
很多朋友刚接触 NAS、Docker 或容器化环境时，都会觉得 IP 地址这种东西似乎理所当然。但等你真的要远程访问、配置代理或者排查网络时，就会发现，知道机器的私有地址是一件非常关键的事。
举几个典型的场景：
想通过 SSH、HTTP 等方式访问运行在懒猫微服上的服务；
需要进行 端口转发 或者把服务 内网穿透到公网；
在 Dockge 里启动容器后，访问的时候必须指定 IP 地址，否则反向代理会失败；
排查网络时，需要确认到底是哪一个 IP 地址在被使用。
换句话说，掌握如何获取私有地址，可以来排除一些域名上转发损失的问题。
虽然在客户端中可以看到网络地址，但是有阵子我修改 br-lan 网桥之后这里就不再显示了。所以才想了个办法来记录网络地址。下面将结合 Python 代码，介绍几种常见的获取私有地址的方法。
下面我会结合 Python 代码和一些常见的工具，介绍几种获取私有地址的常见做法，并分析它们的优缺点。
1. 为什么是“私有地址”
首先我们要搞清楚：什么是 私有地址？
私有地址是 RFC1918 标准定义的局域网网段，常见的有：
10.0.0.0/8172.16.0.0/12192.168.0.0/16
这些 IP 地址不会直接出现在公网，而是专门留给局域网使用。比如：
- 你家路由器分配给手机的
192.168.31.2； - NAS 设备的
192.168.1.103； - Docker 创建虚拟网络时分配的
172.18.0.2。
所以，获取懒猫微服的“私有地址”，本质上就是找到它在局域网环境下的真实 IP。只有掌握了这个 IP，才能在排查问题的时候得心应手。
2. 最常用的快速方法：socket 连接法
在 Python 里，用 socket 模块就能很快拿到主要的私有 IP 地址。代码如下：
import socket
def get_primary_ip():
s = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
try:
# 不会真的发请求，只是借助路由表选择出网口
s.connect(('8.8.8.8', 80))
ip = s.getsockname()[0]
except Exception:
ip = '127.0.0.1'
finally:
s.close()
return ip
print(get_primary_ip())运行后，输出大概是：
192.168.1.2这就是懒猫微服当前在局域网里的主要出网地址。
原理说明
- 代码里
s.connect(('8.8.8.8', 80))看似是去连接 Google 的 DNS，其实并不会真正发起网络请求； - 系统只是会查一遍路由表，决定要走哪个网卡出去；
- 然后
getsockname()返回的就是这个网卡对应的本地 IP。
优缺点
- 优点：跨平台通用，代码简洁，结果非常准确。
- 缺点：依赖于有路由表，如果设备完全没有网络，可能就会返回
127.0.0.1。
这种方法非常适合：家用网络 / 有默认出网口 / 多网卡机器。
3. 另一种简单写法（但容易踩坑）
很多人还会写成：
import socket
print(socket.gethostbyname(socket.gethostname()))这段代码通过 主机名解析 来获取 IP 地址，看似简单，但问题不少：
- 在很多系统里，它直接返回
127.0.0.1； - 依赖
/etc/hosts或 DNS 配置，如果没配好，就会失效； - 在复杂网络环境下，很可能并不是你真正想要的地址。
所以，这种方法虽然一行就能搞定，但更适合在 主机名规范配置过的服务器，不太推荐在 NAS、容器、虚拟机这些环境里依赖。
4. 列出所有网卡的地址
如果环境比较复杂，比如同时有 Wi-Fi、以太网、虚拟网卡、容器网桥，只拿一个主要地址就不够了。这时候就需要直接列出所有接口的 IP，再从中筛选。
使用 ifaddr
安装：
pip install ifaddr --root-user-action=ignore代码：
import ifaddr
adapters = ifaddr.get_adapters()
for adapter in adapters:
for ip in adapter.ips:
print(f"{adapter.nice_name}: {ip.ip}")输出是：
eth0: 192.168.5.203
docker0: 172.17.0.1
lo: 127.0.0.1
使用 psutil
psutil 是更常见的运维库，信息更全面：
pip install psutil --root-user-action=ignore代码：
import psutil, socket
addrs = psutil.net_if_addrs()
for iface, addr_list in addrs.items():
for addr in addr_list:
if addr.family == socket.AF_INET:
print(f"{iface}: {addr.address}")输出会展示每一个网卡的 IPv4 地址：
适合在 虚拟化/容器/复杂网络环境 中使用。
5. 如何区分私有地址与公网地址
如果列出来的地址很多，还混杂了公网 IP，怎么办？可以用 ipaddress 模块过滤：
import ipaddress
def is_private(ip):
return ipaddress.ip_address(ip).is_private
print(is_private("192.168.5.203")) # True
print(is_private("8.8.8.8")) # False这样就能快速区分哪些是真正的私有地址，避免混淆。
6. 实战场景举例
说了这么多，回到实际应用。获取私有地址到底能帮我们解决什么？
为容器配置反向代理 在 Caddyfile 中写：
reverse_proxy http://192.168.1.2:11434就必须确认
192.168.5.203真的是懒猫微服的地址。跨设备访问服务 想用手机访问 NAS 提供的 Web 服务
http://192.168.1.2:8080，也必须提前知道 IP。排查网络问题 当遇到容器内服务报错（403、502）时，确认是不是反向代理到了错误的 IP，就靠这一步。
7. 方法对比表
| 方法 | 示例代码 | 优点 | 缺点 | 适用场景 |
|---|---|---|---|---|
| UDP 连接法 | s.connect(('8.8.8.8', 80)) | 跨平台、常用、结果准确 | 需有路由/网络 | 获取主要私有地址 |
| 主机名解析 | gethostbyname(gethostname()) | 简单，一行搞定 | 常返回 127.0.0.1，依赖配置 | 主机名已配置正确 |
| ifaddr | ifaddr.get_adapters() | 列出所有接口，跨平台 | 需安装库 | 多网卡、容器环境 |
| psutil | psutil.net_if_addrs() | 常见运维库，信息全面 | 需安装库 | 系统监控、诊断 |
| ipaddress | ip_address(ip).is_private | 能区分公网/私网 | 需结合其他方法 | 过滤私有地址 |
总结
获取懒猫微服的私有地址，其实就是获取机器在局域网里的 IP。
- 快速场景：用
socket + 8.8.8.8方法，几乎百分百靠谱； - 一行写法：
gethostbyname(gethostname())，但要注意经常只会返回127.0.0.1； - 复杂环境：用
ifaddr或psutil列出所有接口，再结合ipaddress做筛选。
掌握这些方法，你就能在 部署服务、调试容器、配置代理 时快速定位到懒猫微服的真实 IP，避免因为地址不明导致的各种问题。
以后无论是写 Caddyfile 配置、手机访问 NAS 服务，还是排查 403/502 错误，你都能从容地第一时间确认：**我的懒猫微服，到底在哪个 IP 上运行。
