家用住宅主机Linux etcd分布式存储中转配置文件
前言
家里有多台 Linux 设备（比如树莓派、旧笔记本、NAS），每次修改配置文件都要手动拷贝或写脚本同步，很麻烦。
etcd 是一个轻量级的分布式键值存储组件，通常用于服务发现和配置共享。
本文就用它来做配置文件中转：把常用配置放到 etcd 里，其他设备通过 API 读取，再也不用满天飞复制文件了。
准备工作
- 一台运行 Linux 的家用主机（Ubuntu 20.04/22.04 或 CentOS 7/8 均可，本文以 Ubuntu 22.04 示例）
- 主机需要能联网（安装时下载包）
- 确保 2379（客户端端口）和 2380（集群通信端口）没有被占用
- 如果主机开启了防火墙，需要放行这两个端口
安装 etcd
方法一：使用系统包管理器（推荐新手）
# Ubuntu/Debian
sudo apt update && sudo apt install etcd -y
# CentOS/RHEL
sudo yum install etcd -y安装完成后可以用 etcd --version 查看版本号，目前主流版本为 3.x。
方法二：手动下载二进制（适合需要特定版本或 ARM 架构）
访问 etcd 官方 GitHub Releases 下载对应架构的 tar.gz 包，解压后把 etcd 和 etcdctl 放到 /usr/local/bin 即可。
配置并启动 etcd 服务
etcd 默认配置文件路径为 /etc/etcd/etcd.conf.yml。
我们采用单节点模式作为配置中转，简单可靠。
修改配置文件（如果文件不存在，手动创建）：
# /etc/etcd/etcd.conf.yml
name: 'config-transit'
data-dir: '/var/lib/etcd/default'
listen-client-urls: 'http://0.0.0.0:2379'
advertise-client-urls: 'http://your-server-ip:2379'
listen-peer-urls: 'http://0.0.0.0:2380'
advertise-peer-urls: 'http://your-server-ip:2380'将 your-server-ip 替换为家用主机的实际内网 IP。
如果只在局域网使用，不用 HTTPS，认证后面再说。
启动服务：
sudo systemctl enable etcd
sudo systemctl start etcd
sudo systemctl status etcd # 确认状态为 active (running)核心操作：写入与读取配置文件
etcd 把配置存为键值对，例如：
# 写入 Nginx 代理配置
etcdctl put /config/nginx/upstream '192.168.1.10:8080'
# 读取刚写入的值
etcdctl get /config/nginx/upstream如果想批量存一组配置，可以用 --delimiter 或者直接写 JSON：
etcdctl put /config/app/db '{"host":"192.168.1.20","port":3306,"user":"admin"}'其他设备通过 HTTP API 也能读取：
curl http://192.168.1.5:2379/v2/keys/config/app/db返回 JSON 格式，很方便集成到脚本里。
避坑指南
- 防火墙拦截：家用路由器或主机自带 ufw/firewalld 可能阻止端口访问。执行以下命令放行：
sudo ufw allow 2379/tcp
sudo ufw allow 2380/tcp- 数据持久化：etcd 默认数据目录在
/var/lib/etcd，建议定期备份该目录，或者用etcdctl snapshot save命令。 - 权限控制：如果暴露到公网，务必启用 SSL/TLS 和用户认证。可参考 etcd 官方安全文档，家用局域网可以暂时跳过。
- 启动失败排查：
journalctl -u etcd查看详细日志，常见原因是端口占用或配置文件语法错误（YAML 缩进一定要空格）。
效果验证
- 在主机上执行
etcdctl endpoint health，看到healthy字样说明服务正常。 - 在其他 Linux 设备（同一局域网）上执行
curl http://你的主机IP:2379/version，如果能返回 etcd 版本信息，说明远程访问成功。 - 尝试修改一个配置项，然后在客户端重新读取，验证同步生效。
总结
通过 etcd 作为配置文件中转，家里多台设备就能共享一套配置，修改一次、处处生效。
单节点模式对家用环境完全够用，后续如果需要高可用，可以再添加节点组成真正集群。
如果遇到问题，先检查防火墙和端口占用，大多数故障都出在这两步。
