如何解决Docker中links与host网络的冲突？需连接X11与MariaDB

问题描述 #

我是Docker新手，正在尝试将一个通过mysqlalchemy连接容器化MariaDB服务器的PyQt应用进行容器化。目前已解决应用容器与MariaDB容器的通信问题，但在连接X11服务器时，采用方案后出现错误：host类型网络不能与links混用，会导致未定义行为。我的系统是Fedora 38，使用X11而非Wayland，希望解决该冲突以同时连接MariaDB与X11服务器。

解决方案 #

核心思路是移除network_mode: host与links的冲突组合，改用Docker自定义网络实现容器间通信，同时保留X11访问所需的配置。

1. 修改docker-compose.yml配置 #

移除network_mode: host和links，添加自定义桥接网络，让应用容器与DB容器在同一网络内通信：

version: "3"
volumes:
    data:
# 添加自定义桥接网络
networks:
    app-network:
        driver: bridge
services:
    db:
        container_name: mydb2
        image: mariadb:latest
        ports:
            - "32001:3306"
        environment:
            MYSQL_ROOT_PASSWORD: root
            MYSQL_USER: root
        volumes:
            - data:/var/lib/mysql
        # 将DB容器加入自定义网络
        networks:
            - app-network
    app:
        container_name: biere
        build: ./
        environment:
            - DISPLAY=$DISPLAY
            - QT_DEBUG_PLUGINS=1
        volumes:
            - /tmp/.X11-unix:/tmp/.X11-unix
            - ~/.Xauthority:/root/.Xauthority
        ports:
            - "5001:5000"
        # 将应用容器加入自定义网络
        networks:
            - app-network

2. 调整数据库连接地址 #

修改db_connection.py中的数据库URL，使用Docker Compose服务名db而非容器名mydb2访问MariaDB：

from sqlalchemy import create_engine
from sqlalchemy_utils import create_database, database_exists
from sqlalchemy.orm import sessionmaker, scoped_session
from database.orm_base import Base
# 使用服务名db访问，自定义网络内可直接解析
db_url="mysql+pymysql://root:root@db:3306/a_db"
if not database_exists(db_url):
    create_database(db_url)
engine = create_engine(db_url,pool_size=5,pool_recycle=3600)
Session =sessionmaker(bind=engine,expire_on_commit=False)
session =Session()

3. X11权限检查（可选） #

如果运行容器后仍无法显示PyQt界面，在宿主机执行以下命令允许本地容器访问X11服务器：

xhost +local:

使用完成后，记得收回权限：

xhost -local:

关键说明 #

• 自定义桥接网络：Docker默认桥接网络已支持容器间通过服务名通信，自定义网络提供更好的隔离性与稳定性，无需依赖links。
• 无需host网络：挂载/tmp/.X11-unix和.Xauthority已足够让容器访问宿主机X11，host网络会破坏容器网络隔离且与links冲突，完全没必要使用。
• 服务名访问：使用Docker Compose服务名而非容器名，避免容器名变化导致的连接失败，这是容器间通信的标准方式。

内容的提问来源于stack exchange，提问作者Meaulnes