LinkStack Docker 镜像文档

关于

这是LinkStack的***Docker版本。该Docker镜像部署简单，包含运行LinkStack所需的所有组件。

LinkStack的Docker版本保留了原始版本的所有功能和自定义选项。

此Docker基于Alpine Linux（一个小巧、简单且安全的Linux发行版）构建，Web服务器使用Apache2（免费开源的跨平台Web服务器软件），并内置PHP 8.0以确保高兼容性和性能。

使用Docker镜像就像拉取和部署一样简单。

关于LinkStack

LinkStack是一个高度可定制的链接分享平台，具有直观易用的用户界面。

LinkStack允许您创建个人资料页面。许多社交媒体平台仅允许放置一个链接，而通过LinkStack，您可以将所有需要的链接集中在一个页面上，使其均可点击。只需几步，即可在自己的服务器上搭建个人链接页面。

了解更多关于LinkStack及其所有功能：

关于LinkStack

拉取镜像

shell
docker pull linkstackorg/linkstack

替代镜像源：

shell
docker pull ghcr.io/linkstackorg/linkstack

支持的架构

• linux/amd64
• linux/arm/v6
• linux/arm/v7
• linux/arm64

部署

您可以将端口80、443更改为您偏好的值。默认情况下支持并暴露HTTP和HTTPS。

可选环境变量

• SERVER_ADMIN（管理员***，默认值：***）
• HTTP_SERVER_NAME（服务器名称，默认值：localhost）
• HTTPS_SERVER_NAME（服务器名称，默认值：localhost）
• LOG_LEVEL（日志级别，默认值：info）
• TZ（时区，默认值：UTC）
• PHP_MEMORY_LIMIT（PHP内存限制，默认值：256M）
• UPLOAD_MAX_FILESIZE（上传文件大小限制，默认值：8M）

基本部署

我们建议设置持久化存储
了解更多关于持久化存储的信息

创建新卷：

shell
docker volume create linkstack

shell
docker run --detach \
    --name linkstack \
    --publish 80:80 \
    --publish 443:443 \
    --restart unless-stopped \
    --mount source=linkstack,target=/htdocs \
    linkstackorg/linkstack

自定义部署

shell
docker run --detach \
    --name linkstack \
    --hostname linkstack \
    --env HTTP_SERVER_NAME="[***]" \
    --env HTTPS_SERVER_NAME="[***]" \
    --env SERVER_ADMIN="***" \
    --env TZ="Europe/Berlin" \
    --env PHP_MEMORY_LIMIT="512M" \
    --env UPLOAD_MAX_FILESIZE="16M" \
    --publish 80:80 \
    --publish 443:443 \
    --restart unless-stopped \
    --mount source=linkstack,target=/htdocs \
    linkstackorg/linkstack

Docker Compose

为避免问题，请为反向代理使用HTTPS

示例配置：

yaml
version: "3.8"

services:

  linkstack:
    hostname: 'linkstack'
    image: 'linkstackorg/linkstack:latest'
    environment:
      TZ: 'Europe/Berlin'
      SERVER_ADMIN: '***'
      HTTP_SERVER_NAME: 'example.com'
      HTTPS_SERVER_NAME: 'example.com'
      LOG_LEVEL: 'info'
      PHP_MEMORY_LIMIT: '256M'
      UPLOAD_MAX_FILESIZE: '8M'
    volumes:
      - 'linkstack_data:/htdocs'
    ports:
      - '8190:443'
    restart: unless-stopped

volumes:
  linkstack_data:

更新

当有新版本发布时，您将在管理面板上收到更新通知。

一键自动更新器

此更新器允许您一键更新安装。

如何使用自动更新器：

• 要更新实例，请点击管理面板上的更新通知。
• 点击“自动更新”，更新器将处理其余步骤。

构建

如果您希望构建或修改自己的LinkStack Docker版本，可以按照以下说明操作：

• 下载此GitHub仓库以及LinkStack的最新版本，从这里获取。
• 将下载的发布文件直接放入此仓库的linkstack文件夹中（从此仓库下载）。

从docker目录运行以下命令：

shell
docker build -t linkstack .

现在您可以在定义的端口上设置应用程序。

持久化存储

Docker容器的持久化存储是在容器停止或删除时不会丢失的存储。

这一特性非常有用，因为即使容器被删除，数据也可以保存。当处理需要在重启过程中保留的数据（如数据库）时，这一点尤为重要。

运行LinkStack所需的所有重要文件都存储在docker容器根目录下的"htdocs"文件夹中。

我们建议将整个文件夹挂载到外部卷。

不过，有些用户可能希望只保留个别文件。
展开下面的详细部分了解更多：

/htdocs/.env
/htdocs/database/database.sqlite
/htdocs/config/advanced-config.php
/htdocs/assets/linkstack/images/avatar.png
/htdocs/themes (文件夹)
/htdocs/assets/img (文件夹)

反向代理

NGINX：

以下是NGINX反向代理的示例配置。

确保使用HTTPS访问容器以避免混合内容错误

nginx
server {
  listen        443 ssl;
  listen        [::]:443 ssl;
  listen        80;
  listen        [::]:80;
  server_name   your.domain.name;

  location / {
    # 替换为Docker容器的IP地址和端口号
    proxy_pass                          [***]
    proxy_set_header Host               $host;
    proxy_set_header X-Real-IP          $remote_addr;

    proxy_set_header X-Forwarded-For    $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto  https;
    proxy_set_header X-VerifiedViaNginx yes;
    proxy_read_timeout                  60;
    proxy_connect_timeout               60;
    proxy_redirect                      off;

    # WebSocket专用：强制使用HTTP/1.1并设置Upgrade头
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection 'upgrade';
    proxy_cache_bypass $http_upgrade;
    proxy_set_header X-Forwarded-Proto $scheme;
    
    # 修复混合内容错误
    add_header 'Content-Security-Policy' 'upgrade-insecure-requests';
  }
}