Shlink项目Docker部署中的端口映射问题解析

在使用Shlink开源短链接服务进行Docker部署时，一个常见的配置错误是端口映射设置不当。本文将通过一个实际案例，详细分析这类问题的表现和解决方案。

问题现象

在Docker环境中部署Shlink时，用户按照官方文档配置了基本的docker-compose文件后，能够正常访问到预期的404页面。但当用户尝试扩展配置，添加MariaDB数据库支持后，服务突然变得不可访问。

查看容器日志时，虽然显示了一些关于ORM代理生成的错误信息，但这些实际上是Shlink正常初始化过程中的日志输出，并非真正的错误。真正的症结在于服务端口配置。

根本原因

经过分析，发现问题出在docker-compose文件的端口映射配置上：

ports:
  - 8081:8081

正确的映射应该是将宿主机的端口映射到容器内部的8080端口：

ports:
  - 8081:8080

技术细节

Shlink的Docker镜像内部默认监听的是8080端口，这是由应用程序本身的配置决定的。当我们在docker-compose中进行端口映射时，左侧是宿主机端口，右侧是容器内部端口。错误的映射会导致请求无法正确路由到Shlink服务。

解决方案

修正端口映射配置后，服务立即恢复正常。完整的正确配置示例如下：

version: '3'

services:
  shlink:
    image: shlinkio/shlink:stable
    ports:
      - 8081:8080  # 关键修正点
    environment:
      - DEFAULT_DOMAIN=mydomain.com
      - DB_DRIVER=maria
      - DB_USER=shlink
      - DB_NAME=shlink
      - DB_PASSWORD=dbpassword
      - DB_HOST=sh_database
    depends_on:
      - sh_database

  sh_database:
    image: mariadb:latest
    environment:
      - MARIADB_ROOT_PASSWORD=mbpassword
      - MARIADB_DATABASE=shlink
      - MARIADB_USER=shlink
      - MARIADB_PASSWORD=mbpassword
    volumes:
      - ./db_data:/var/lib/mysql

经验总结

1. 在Docker部署时，务必确认应用程序实际监听的内部端口
2. 日志中的"错误"信息需要仔细甄别，有些可能是正常初始化过程
3. 对于Shlink这类应用，404页面反而是服务正常运行的标志
4. 环境变量配置要特别注意大小写和拼写准确性

通过这个案例，我们可以了解到Docker部署中端口映射的重要性，以及如何正确解读容器日志信息。这些经验同样适用于其他类似服务的部署过程。