riscv64/yourls

注意： 这是https://hub.docker.com/_/yourls%E7%9A%84%60riscv64%60%E6%9E%B6%E6%9E%84%E6%9E%84%E5%BB%BA%E7%9A%84%22%E6%AF%8F%E4%B8%AA%E6%9E%B6%E6%9E%84%22%E4%BB%93%E5%BA%93 — 更多信息，请参见官方镜像文档中的"除amd64之外的架构？"和官方镜像FAQ中的"Git中的镜像源已更改，现在该怎么办？"。

快速参考

• 维护者：
  https://github.com/YOURLS/containers

• 获取帮助：
  Docker社区Slack、Server Fault、Unix & Linux或Stack Overflow

支持的标签及相应的Dockerfile链接

• https://github.com/YOURLS/containers/blob/da811947acac487e9eae4f4ccc73509b5eea5eeb/apache/Dockerfile

• https://github.com/YOURLS/containers/blob/da811947acac487e9eae4f4ccc73509b5eea5eeb/fpm/Dockerfile

• https://github.com/YOURLS/containers/blob/da811947acac487e9eae4f4ccc73509b5eea5eeb/fpm-alpine/Dockerfile

快速参考（续）

• 问题提交地址：
  https://github.com/YOURLS/containers/issues?q=

• 支持的架构： (https://github.com/docker-library/official-images#architectures-other-than-amd64)
  https://hub.docker.com/r/amd64/yourls/%E3%80%81https://hub.docker.com/r/arm32v5/yourls/%E3%80%81https://hub.docker.com/r/arm32v6/yourls/%E3%80%81https://hub.docker.com/r/arm32v7/yourls/%E3%80%81https://hub.docker.com/r/arm64v8/yourls/%E3%80%81https://hub.docker.com/r/i386/yourls/%E3%80%81https://hub.docker.com/r/ppc64le/yourls/%E3%80%81https://hub.docker.com/r/riscv64/yourls/%E3%80%81https://hub.docker.com/r/s390x/yourls/

• 已发布镜像工件详情：
  https://github.com/docker-library/repo-info/blob/master/repos/yourls (https://github.com/docker-library/repo-info/commits/master/repos/yourls)
  （镜像元数据、传输大小等）

• 镜像更新：
  https://github.com/docker-library/official-images/issues?q=label%3Alibrary%2Fyourls
  https://github.com/docker-library/official-images/blob/master/library/yourls (https://github.com/docker-library/official-images/commits/master/library/yourls)

• 此描述的来源：
  https://github.com/docker-library/docs/tree/master/yourls (https://github.com/docker-library/docs/commits/master/yourls)

什么是YOURLS？

YOURLS是一套PHP脚本，允许您运行自己的URL缩短器。您将完全控制您的数据、详细统计、分析、插件等。它是免费的。

https://github.com/YOURLS/YOURLS

!https://raw.githubusercontent.com/docker-library/docs/1b75e08d68679797623d98ba82ca80090f5a26d2/yourls/logo.svg?sanitize=true

如何使用此镜像

启动riscv64/yourls服务器实例

bash
docker run \
    --name some-yourls \
    --detach \
    --network some-network \
    --env YOURLS_SITE="https://example.com" \
    --env YOURLS_USER="example_username" \
    --env YOURLS_PASS="example_password" \
    riscv64/yourls

YOURLS实例接受许多环境变量进行配置，详见下面的"环境变量"部分。

如果您想使用外部数据库而不是mysql容器，请使用YOURLS_DB_HOST指定主机名和端口，以及YOURLS_DB_PASS中的密码和YOURLS_DB_USER中的用户名（如果不是root）：

bash
docker run \
    --name some-yourls \
    --detach \
    --env YOURLS_DB_HOST=... \
    --env YOURLS_DB_USER=... \
    --env YOURLS_DB_PASS=... \
    riscv64/yourls

连接到YOURLS管理界面

如果您希望能够从主机访问实例而无需容器的IP，可以使用标准端口映射：

bash
docker run \
    --name some-yourls \
    --detach \
    --network some-network \
    --publish 8080:8080 \
    riscv64/yourls

然后，在浏览器中通过http://localhost:8080/admin/或http://<host-ip>:8080/admin/访问它。

注意： 在首次实例化时，访问根文件夹会产生错误。通过路径/admin/访问YOURLS管理界面。

环境变量

启动yourls镜像时，您可以通过在docker run命令行上传递一个或多个环境变量来调整YOURLS实例的配置。
YOURLS实例接受许多用于配置的环境变量。
使用此Docker镜像的一些值得注意/重要的示例包括以下内容。

YOURLS_SITE

必需。
YOURLS实例URL，无尾部斜杠，小写。

示例：YOURLS_SITE="https://example.com"

YOURLS_USER

必需。
YOURLS实例用户名。

示例：YOURLS_USER="example_username"

YOURLS_PASS

必需。
YOURLS实例密码。

示例：YOURLS_PASS="example_password"

YOURLS_DB_HOST、YOURLS_DB_USER、YOURLS_DB_PASS

如果链接了mysql容器，则可选。

数据库的主机、用户（默认为root）和密码。

YOURLS_DB_NAME

可选。
数据库名称，默认为yourls。安装YOURLS之前必须创建数据库。

YOURLS_DB_PREFIX

可选。
数据库表前缀，默认为yourls_。仅在需要覆盖默认表前缀时设置此选项。

Docker Secrets

作为通过环境变量传递敏感信息的替代方法，可以将_FILE附加到前面列出的环境变量，使初始化脚本从容器中存在的文件加载这些变量的值。特别是，这可用于从存储在/run/secrets/<secret_name>文件中的Docker密钥加载密码。例如：

bash
docker run \
    --name some-yourls \
    --detach \
    --env YOURLS_DB_PASS_FILE=/run/secrets/mysql-root \
    riscv64/yourls

目前，这支持YOURLS_DB_HOST、YOURLS_DB_USER、YOURLS_DB_PASS、YOURLS_DB_NAME、YOURLS_DB_PREFIX、YOURLS_SITE、YOURLS_USER和YOURLS_PASS。

... 通过https://github.com/docker/compose

yourls的compose.yaml示例：

yaml
name: yourls
services:
  yourls:
    image: yourls
    restart: always
    depends_on:
      - mysql
    ports:
      - 8080:8080
    environment:
      YOURLS_DB_PASS: example
      YOURLS_SITE: https://example.com
      YOURLS_USER: example_username
      YOURLS_PASS: example_password
  mysql:
    image: mysql
    restart: always
    environment:
      MYSQL_ROOT_PASSWORD: example
      MYSQL_DATABASE: yourls
    volumes:
      - db:/var/lib/mysql

运行docker compose up，等待其完全初始化，然后访问http://localhost:8080/admin/或http://<host-ip>:8080/admin/（视情况而定）。

添加额外的库/扩展

此镜像不提供任何额外的PHP扩展或其他库，即使它们是流行插件所必需的。有无数可能的插件，它们可能需要PHP支持的任何扩展。包含所有存在的PHP扩展将大大增加镜像大小。

如果您需要其他PHP扩展，您需要创建自己的镜像FROM此镜像。https://github.com/docker-library/docs/blob/master/php/README.md#how-to-install-more-php-extensions%E8%A7%A3%E9%87%8A%E4%BA%86%E5%A6%82%E4%BD%95%E7%BC%96%E8%AF%91%E5%85%B6%E4%BB%96%E6%89%A9%E5%B1%95%E3%80%82

包含持久用户内容

将包含您的插件、页面或语言的卷挂载到适当的目录；然后通过"admin"UI应用它们。确保用户具有读/写/执行权限：

• 插件位于/var/www/html/user/plugins/中的子目录中
• 页面位于/var/www/html/user/pages/中的子目录中
• 语言位于/var/www/html/user/languages/中的子目录中

如果您希望在镜像中提供额外内容以在多个安装中部署，请将其放在/usr/src/yourls/下的相同目录中（在容器初始启动时复制到/var/www/html/）。

镜像变体

riscv64/yourls镜像有多种风格，每种风格都设计用于特定用例。

riscv64/yourls:<version>

这是事实上的镜像。如果您不确定自己的需求，您可能想要使用这个。它设计为既可作为一次性容器使用（挂载您的源代码并启动容器以启动您的应用程序），也可作为构建其他镜像的基础。

riscv64/yourls:<version>-fpm

此变体包含PHP的FastCGI进程管理器(FPM)，这是推荐的PHP FastCGI实现。

为了使用此镜像变体，需要某种反向代理（如NGINX、Apache或其他支持FastCGI协议的工具）。

警告： FastCGI协议本质上是信任的，因此在私有容器网络之外公开是极其不安全的 — 除非您确切知道自己在做什么（并且愿意接受极端风险），否则不要将Docker的--publish(-p)标志与此镜像变体一起使用。

FPM配置

此变体有几个FPM配置文件，每个文件提供一小组指令。

• /usr/local/etc/php-fpm.conf：这是PHP上游提供的主要配置文件。唯一未被注释的是[global]部分下的include for php-fpm.d/*.conf。
• /usr/local/etc/php-fpm.d/docker.conf：这是特定于镜像的配置，使FPM更容易在Docker下运行。通过理解，这些可以在用户提供的配置中被覆盖。
• /usr/local/etc/php-fpm.d/www.conf：这是PHP上游提供的www池配置，对镜像进行了 minor 修改。可以根据需要在以后的配置文件中编辑、替换或覆盖此文件。
• /usr/local/etc/php-fpm.d/zz-docker.conf：截至2026年1月，此文件仅包含[global]指令下的daemonize = no。这不应该被覆盖。

建议将用户配置放在/usr/local/etc/php-fpm.d/中的自己的.conf文件中。文件按glob顺序包含，因此它们根据当前区域设置中的排序序列进行排序。后面的文件可以覆盖前面文件的配置。另请参见FPM的官方配置参考。

以下是使用Dockerfile添加自定义FPM配置的示例。

Dockerfile
FROM php:8-fpm
RUN set -eux; \
	{ \
		echo '[www]'; \
		echo 'pm.status_path = /status'; \
	} > /usr/local/etc/php-fpm.d/my-fpm.conf

或者，运行时的绑定挂载文件可以使用，只要容器用户（默认情况下为镜像的www-data）可以读取它（例如docker run上的--mount type=bind,src=path/to/my-fpm.conf,dst=/usr/local/etc/php-fpm.d/my-fpm.conf）。当将配置文件文件夹挂载到整个/usr/local/etc/php-fpm.d/目录时（例如--mount type=bind,src=path/to/fpm.d/,dst=/usr/local/etc/php-fpm.d/），必须特别小心；这会替换镜像的php-fpm.d目录，因此来自镜像提供的配置文件的任何必要指令（如daemonize = no）必须在用户提供的文件中。

一些其他可能有帮助的资源：

• https://gist.github.com/md5/d9206eacb5a0ff5d6be0
• Pascal Landau的非常详细的文章
• Stack Overflow讨论
• Apache httpd Wiki示例

许可证

查看此镜像中包含的软件的https://github.com/YOURLS/YOURLS/blob/master/LICENSE%E3%80%82

与所有Docker镜像一样，这些镜像可能还包含其他可能受其他许可证约束的软件（例如来自基础发行版的Bash等，以及包含的主要软件的任何直接或间接依赖项）。

一些能够自动检测到的其他许可证信息可能会在https://github.com/docker-library/repo-info/tree/master/repos/yourls%E4%B8%AD%E6%89%BE%E5%88%B0%E3%80%82

至于任何预构建镜像的使用，镜像用户有责任确保对此镜像的任何使用符合其中包含的所有软件的任何相关许可证。