Как отключить IPv6 в Poste.io Docker контейнере

Чтобы отключить IPv6 в контейнере Poste.io и его конфигурации при использовании Docker, вам потребуется настроить параметры привязки сервисов к IPv4-адресам вместо IPv6. Проблема возникает, поскольку сервисы пытаются привязаться к IPv6-адресам, которые недоступны в вашей среде.

Содержание

• Основные подходы к решению
• Конфигурация через server.ini
• Ручная настройка сервисов
• Настройка Docker сети
• Проверка и тестирование
• Альтернативные решения

Основные подходы к решению

Существует несколько способов отключить IPv6 в Poste.io при работе через Docker:

1. Настройка через server.ini - основной конфигурационный файл Poste.io
2. Ручная настройка отдельных сервисов (Postfix, Dovecot, Nginx)
3. Конфигурация Docker сети - настройка параметров сети на уровне контейнера
4. Использование переменных окружения - передача параметров через Docker

Наиболее предпочтительным является комбинированный подход, начиная с настройки server.ini, так как это основной конфигурационный файл Poste.io.

Конфигурация через server.ini

Файл server.ini является основным конфигурационным файлом Poste.io. Хотя информации о нем в сети мало, он поддерживает параметры для управления привязкой к сетевым интерфейсам:

[server]
bind = 0.0.0.0
ipv6 = false

Если стандартные параметры не работают, попробуйте следующие варианты:

[server]
listen_addresses = 127.0.0.1,::1
disable_ipv6 = true

Для более детальной настройки отдельных сервисов:

[postfix]
inet_interfaces = all
inet_protocols = ipv4

[dovecot]
listen = *,[::]
disable_plaintext_auth = no
ssl = required
ssl_cert = </etc/ssl/certs/poste.io/cert.pem
ssl_key = </etc/ssl/certs/poste.io/key.pem

[nginx]
listen = [::]:80
listen = [::]:443 ssl

Если вы используете Docker Compose, добавьте эти параметры в том с конфигурацией:

volumes:
  - ./config:/config
  - ./server.ini:/config/server.ini

Ручная настройка сервисов

Настройка Postfix

Отредактируйте файл main.cf в конфигурации Poste.io:

# /config/postfix/main.cf
inet_interfaces = all
inet_protocols = ipv4
smtp_bind_address = 0.0.0.0
smtp_bind_address6 = [::]

Настройка Dovecot

Отредактируйте файл dovecot.conf:

# /config/dovecot/dovecot.conf
listen = *,[::]
disable_plaintext_auth = no
ssl = required

Настройка Nginx

Отредактируйте файл nginx.conf:

# /config/nginx/nginx.conf
server {
    listen 80;
    listen [::]:80;
    server_name your.domain.com;
    
    listen 443 ssl;
    listen [::]:443 ssl;
    
    ssl_certificate /etc/ssl/certs/poste.io/cert.pem;
    ssl_certificate_key /etc/ssl/certs/poste.io/key.pem;
}

Настройка Docker сети

Добавьте параметры в Docker Compose файл для отключения IPv6 на уровне контейнера:

version: '3'
services:
  poste:
    image: posteio/poste.io
    container_name: poste
    ports:
      - "25:25"
      - "587:587"
      - "465:465"
      - "80:80"
      - "443:443"
    volumes:
      - ./data:/data
      - ./config:/config
    environment:
      - DISABLE_IPV6=true
      - POSTFIX_INET_PROTOCOLS=ipv4
      - DOVECOT_LISTEN=*,127.0.0.1
    network_mode: bridge
    cap_add:
      - NET_ADMIN
    sysctls:
      - net.ipv6.conf.all.disable_ipv6=1
      - net.ipv6.conf.default.disable_ipv6=1

Или используйте команду Docker для запуска с параметрами:

docker run -d \
  --name poste \
  -p 25:25 \
  -p 587:587 \
  -p 465:465 \
  -p 80:80 \
  -p 443:443 \
  -v /path/to/data:/data \
  -v /path/to/config:/config \
  --sysctl net.ipv6.conf.all.disable_ipv6=1 \
  --sysctl net.ipv6.conf.default.disable_ipv6=1 \
  posteio/poste.io

Проверка и тестирование

После внесения изменений проверьте настройки:

1. Проверка статуса контейнера:

   bash

   docker logs poste
   

2. Проверка привязки портов:

   bash

   netstat -tlnp | grep -E '25|587|465|80|443'
   

3. Проверка IPv6 статуса:

   bash

   docker exec poste cat /proc/sys/net/ipv6/conf/all/disable_ipv6
   

4. Тестирование работы сервисов:

   bash

   telnet localhost 25
   telnet localhost 587
   

Альтернативные решения

Если вышеуказанные методы не работают, рассмотрите следующие варианты:

1. Использование пользовательского Dockerfile

Создайте кастомный Dockerfile:

FROM posteio/poste.io

RUN echo '[server]\nbind = 0.0.0.0\nipv6 = false' > /config/server.ini
RUN echo 'inet_protocols = ipv4' >> /config/postfix/main.cf
RUN echo 'listen = 127.0.0.1' >> /config/dovecot/dovecot.conf

CMD ["poste"]

2. Использование скрипта инициализации

Создайте скрипт, который будет выполняться при запуске контейнера:

#!/bin/bash
# disable-ipv6.sh

# Отключаем IPv6 в конфигурации
echo '[server]' > /config/server.ini
echo 'bind = 0.0.0.0' >> /config/server.ini
echo 'ipv6 = false' >> /config/server.ini

# Настраиваем Postfix
sed -i 's/inet_protocols = all/inet_protocols = ipv4/' /config/postfix/main.cf

# Настраиваем Dovecot
sed -i 's/listen = \\*,\\[::\\]/listen = 127.0.0.1/' /config/dovecot/dovecot.conf

# Запускаем Poste.io
exec "$@"

3. Использование Docker-сетей

Создайте кастомную Docker сеть без IPv6:

docker network create --ipv4-only --internal poste-network

И запустите контейнер в этой сети:

docker run -d --network poste-network posteio/poste.io

При решении проблемы отключения IPv6 в Poste.io важно понимать, что это комплексная задача, требующая одновременной настройки нескольких уровней: операционной системы, Docker, самого Poste.io и его компонентов. Начинайте с самых простых методов (настройка server.ini) и постепенно переходите к более сложным, если предыдущие не дали результата.

Источники

1. Poste.io Documentation
2. Docker Networking Documentation
3. Postfix Configuration Guide
4. Dovecot Configuration
5. Nginx Server Configuration