1Panel 中跑 CatWrt 旁路网关 Docker 版 OpenWrt
内容提要
本文介绍了在1Panel中安装CatWrt旁路网关的方法，包括开启网卡混杂模式、创建网卡、使用Cattools修改IP地址以及特殊设置CatWrt-rootfs插件或软件。
延伸解读
macvlan 网络配置要点
创建 macvlan 网络时，subnet 和 gateway 必须根据实际局域网环境填写。例如，若主路由网段为 192.168.1.0/24，则 subnet 应设为 192.168.1.0/24，gateway 为主路由 IP。同时，parent 参数需指定为宿主机物理网卡名称（如 enp0s18），否则容器无法与局域网通信。配置后可用 docker network ls 验证网络是否创建成功。
tun 模块加载与检查
CatWrt 容器需要 tun 模块支持，若宿主机未加载，需执行 sudo modprobe tun 手动加载，并通过 lsmod | grep tun 确认。在 docker-compose 配置中，已通过 devices 映射 /dev/net/tun 并添加 SYS_MODULE 权限，但若宿主机内核未加载 tun，容器内仍可能无法使用。建议在启动容器前确保模块已加载，避免后续网络功能异常。
Cattools 修改 IP 的注意事项
使用 Cattools 修改 CatWrt 的 IP 时，由于此时容器尚未联网，脚本会尝试从网络获取最新版本但可能失败，并自动回退到离线版本。过程中会多次重试，切勿手动中断，否则可能导致配置不完整。修改 IP 后，需确保新 IP 与宿主机所在网段一致，否则将无法通过局域网访问 CatWrt。
插件与软件的特殊设置
CatWrt-rootfs 中的许多插件或软件需要额外配置才能正常使用，部分功能可能受限。作者也提到这是首次尝试 rootfs 版本，尚未充分测试。若遇到问题，可参考 Cattools 中的软件源配置或网络诊断工具，也可在评论区与其他用户交流。建议在正式使用前，先测试关键功能是否满足需求。
Q&A
如何在1Panel中安装CatWrt旁路网关？
在1Panel中安装CatWrt旁路网关需要开启网卡混杂模式、创建网卡、使用docker命令创建macvlan网络，并在1Panel中创建编排。
在Debian上如何开启网卡混杂模式？
可以使用命令'sudo ip link set ens18 promisc on'来开启Debian上的网卡混杂模式。
CatWrt-rootfs的最新版本是什么？
CatWrt-rootfs的最新版本是v24.9。
如何使用Cattools修改CatWrt的IP地址？
可以通过在CatWrt终端中运行'cattools'，然后选择设置IP的选项来修改CatWrt的IP地址。
在创建网卡时需要注意哪些配置？
创建网卡时需要根据网络环境配置subnet和gateway，例如subnet=10.0.0.0/24和gateway=10.0.0.4。
CatWrt-rootfs有哪些插件或软件需要特殊设置？
CatWrt-rootfs包含许多插件或软件，用户在使用时可能需要进行特殊设置，具体问题可以在评论区交流。
