ghcr.io/linuxserver/obsidian:amd64-v1.13.7-ls146

https://linuxserver.io 团队为您带来又一个容器版本，其特点包括：

• 定期且及时的应用更新
• 简单的用户映射（PGID、PUID）
• 带有s6 overlay的自定义基础镜像
• 每周基础操作系统更新，在整个LinuxServer.io生态系统中共享通用层，以最小化空间占用、停机时间和带宽
• 定期安全更新

您可以通过以下渠道找到我们：

• https://blog.linuxserver.io - 关于如何使用我们的容器的所有内容，包括操作指南、观点等更多信息！
• https://linuxserver.io/*** - 与社区和团队进行实时支持/聊天。
• https://discourse.linuxserver.io - 在我们的社区论坛上发帖。
• https://github.com/linuxserver - 查看我们所有仓库的源代码。
• https://opencollective.com/linuxserver - 请考虑通过***或为我们的预算做出贡献来帮助我们

https://github.com/linuxserver/docker-obsidian

Obsidian 是一款笔记应用，可让您在设备上创建、链接和组织笔记，并提供数百种插件和主题来自定义您的工作流程。您还可以在线发布笔记、离线访问笔记，并通过端到端加密安全同步笔记。

支持的架构

我们利用docker manifest实现多平台支持。更多信息可从docker https://distribution.github.io/distribution/spec/manifest-v2-2/#manifest-list和我们的公告https://blog.linuxserver.io/2019/02/21/the-lsio-pipeline-project/获取。

只需拉取 lscr.io/linuxserver/obsidian:latest 即可获取适合您架构的正确镜像，但您也可以通过标签拉取特定架构的镜像。

此镜像支持的架构如下：

应用设置

可通过以下地址访问应用：

• [***]

严格反向代理

此镜像默认使用自签名证书。这自然意味着协议为 https。如果您使用的反向代理会验证证书，则需要https://docs.linuxserver.io/faq#strict-proxy。

此容器基于 https://github.com/linuxserver/docker-baseimage-selkies，可将桌面或单个应用流式传输到您的 Web 浏览器。以下仅涵盖基本内容，完整平台文档请参见 https://docs.linuxserver.io/selkies/。

最小化启动

我们遇到的大多数支持问题都源于多年论坛帖子积累的大型运行配置。这些容器设计为几乎无需额外配置即可运行。请先使用以下最小化命令，确认其正常工作，然后再逐个添加您的选项（卷、环境变量、GPU 标志）：

docker run --rm -it \
--shm-size=1gb \
-p 3001:3001 \
lscr.io/linuxserver/obsidian:latest bash

GPU 加速

GPU 是可选的，CPU 处理管道在普通硬件上已足够快速，可实现流畅会话。当 GPU 挂载到容器中时，会自动检测并配置为零复制渲染和编码，设置 AUTO_GPU=false 可禁用此行为。

Intel / AMD（开源驱动程序），只需一个标志：

docker run --rm -it \
--shm-size=1gb \
-p 3001:3001 \
--device /dev/dri \
lscr.io/linuxserver/obsidian:latest bash

Nvidia（专有驱动程序，不适用于基于 Alpine 的镜像）：

需要从 Nvidia 直接下载的 .run 文件安装主机驱动程序 580 或更高版本。对于 595.80 之前的驱动程序，您可能还需要内核参数和虚拟插头，在提交问题前请参见 https://docs.linuxserver.io/selkies/user-guide/gpu/。

docker run --rm -it \
--shm-size=1gb \
-p 3001:3001 \
--runtime nvidia \
--gpus all \
--device /dev/nvidia-modeset \
lscr.io/linuxserver/obsidian:latest bash

Compose 示例、多 GPU 选择（DRINODE/DRI_NODE）、Unraid 说明以及逐步调试循环均在 https://docs.linuxserver.io/selkies/user-guide/gpu/ 指南中。

安全性

[!WARNING] 此容器提供对主机系统的特权访问。除非已正确配置安全措施，否则不要将其暴露在互联网上。

需要 HTTPS。 用于视频和音频的现代浏览器功能（WebCodecs）仅在安全上下文中工作。端口 3001 直接提供 HTTPS 服务，HTTP 端口仅用于位于反向代理之后。

默认情况下无身份验证。设置 CUSTOM_USER 和 PASSWORD 环境变量可启用 HTTP 基本身份验证，这仅适用于受信任的本地网络。若要暴露在互联网上，请将容器置于具有强大身份验证的反向代理之后，例如 https://github.com/linuxserver/docker-swag。请注意，Web 界面包含一个无需密码的 sudo 终端，任何能够访问 GUI 的人都可以在容器内获得 root 权限。

身份验证选项、共享链接行为、容器隔离以及信息亭式部署的锁定变量在 https://docs.linuxserver.io/selkies/user-guide/security/ 中介绍。

语言支持 - 国际化

要以其他语言启动会话，请设置 LC_ALL 环境变量，例如 -e LC_ALL=zh_CN.UTF-8（中文）、ja_JP.UTF-8（日语）、ko_KR.UTF-8（韩语）、ar_AE.UTF-8（阿拉伯语）、ru_RU.UTF-8（俄语）、es_MX.UTF-8（西班牙语 - 拉丁美洲）、de_DE.UTF-8（德语）、fr_FR.UTF-8（法语）、nl_NL.UTF-8（荷兰语）、it_IT.UTF-8（意大利语）。

Beyond Running the App

此镜像继承了 Selkies 平台的所有功能，所有功能均在文档网站上有详细说明：

使用方法

为帮助您开始使用此镜像创建容器，您可以使用 docker-compose 或 docker 命令行工具。

[!NOTE] 除非参数标记为“可选”，否则均为必填项，必须提供值。

docker-compose（推荐，https://docs.linuxserver.io/general/docker-compose）

---
services:
obsidian:
image: lscr.io/linuxserver/obsidian:latest
container_name: obsidian
environment:
- PUID=1000
- PGID=1000
- TZ=Etc/UTC
volumes:
- /path/to/config:/config
ports:
- 3000:3000
- 3001:3001
shm_size: "1gb"
restart: unless-stopped

docker 命令行（https://docs.docker.com/engine/reference/commandline/cli/）

docker run -d \
--name=obsidian \
-e PUID=1000 \
-e PGID=1000 \
-e TZ=Etc/UTC \
-p 3000:3000 \
-p 3001:3001 \
-v /path/to/config:/config \
--shm-size="1gb" \
--restart unless-stopped \
lscr.io/linuxserver/obsidian:latest

参数

容器通过运行时传递的参数进行配置（如上文所示）。这些参数用冒号分隔，分别表示 :。例如，-p 8080:80 会将容器内的 80 端口暴露出来，可通过主机 IP 的 8080 端口从外部访问。

来自文件的环境变量（Docker 密钥）

您可以通过使用特殊前缀 FILE__ 从文件中设置任何环境变量。

例如：

-e FILE__MYVAR=/run/secrets/mysecretvariable

将根据 /run/secrets/mysecretvariable 文件的内容设置环境变量 MYVAR。

运行应用程序的 Umask

对于我们所有的镜像，您可以使用可选的 -e UMASK=022 设置覆盖容器内启动的服务的默认 umask 设置。请记住，umask 不是 chmod，它根据其值减去权限，而不是添加权限。在寻求支持之前，请在此处了解相关信息。

用户/组标识符

使用卷（-v 标志）时，主机操作系统和容器之间可能会出现权限问题，我们通过允许您指定用户 PUID 和组 PGID 来避免此问题。

确保主机上的所有卷目录都归您指定的用户所有，这样任何权限问题都会奇迹般地消失。

在本示例中 PUID=1000 且 PGID=1000，要查找您的 PUID 和 PGID，请使用 id your_user 命令，如下所示：

id your_user

示例输出：

uid=1000(your_user) gid=1000(your_user) groups=1000(your_user)

Docker Mods

我们发布了各种 https://github.com/linuxserver/docker-mods，以在容器内启用额外功能。可用于此镜像的 Mod 列表（如有）以及可应用于我们任何镜像的通用 Mod 可通过上方的动态徽章访问。

支持信息

• 容器运行时的 Shell 访问：

docker exec -it obsidian /bin/bash

• 实时监控容器日志：

docker logs -f obsidian

• 容器版本号：

docker inspect -f '{{ index .Config.Labels "build_version" }}' obsidian

• 镜像版本号：

docker inspect -f '{{ index .Config.Labels "build_version" }}' lscr.io/linuxserver/obsidian:latest

更新信息

我们的大多数镜像是静态的、版本化的，需要更新镜像并重新创建容器才能更新内部的应用程序。除某些例外情况（在相关 readme.md 中注明）外，我们不建议也不支持在容器内更新应用程序。请查阅上文的应用程序设置部分，了解是否建议对此镜像进行应用程序更新。

以下是更新容器的说明：

通过 Docker Compose

• 更新镜像：
• 所有镜像：

docker-compose pull

• 单个镜像：

docker-compose pull obsidian

• 更新容器：
• 所有容器：

docker-compose up -d

• 单个容器：

docker-compose up -d obsidian

• 您还可以删除旧的悬空镜像：

docker image prune

通过 Docker Run

• 更新镜像：

docker pull lscr.io/linuxserver/obsidian:latest

• 停止运行中的容器：

docker stop obsidian

• 删除容器：

docker rm obsidian

• 使用上述相同的 docker run 参数重新创建新容器（如果正确映射到主机文件夹，您的 /config 文件夹和设置将被保留）
• 您还可以删除旧的悬空镜像：

docker image prune

镜像更新通知 - Diun（Docker 镜像更新通知器）

[!TIP] 我们推荐使用 https://crazymax.dev/diun/ 接收更新通知。不建议也不支持使用其他无人值守自动更新容器的工具。

本地构建

如果出于开发目的或仅为自定义逻辑需要对这些镜像进行本地修改：

git clone https://github.com/linuxserver/docker-obsidian.git
cd docker-obsidian
docker build \
--no-cache \
--pull \
-t lscr.io/linuxserver/obsidian:latest .

可使用 lscr.io/linuxserver/qemu-static 在 x86_64 硬件上构建 ARM 变体，反之亦然：

docker run --rm --privileged lscr.io/linuxserver/qemu-static --reset

注册后，您可以使用 -f Dockerfile.aarch64 指定要使用的 Dockerfile。

版本

• 03.04.26: - 通过 PIXELFLUX_WAYLAND=false 默认禁用 Wayland。
• 20.03.26: - 使用 Wayland ozone 平台修复缩放和加速问题。
• 28.12.25: - 添加 Wayland 初始化逻辑。
• 21.09.25: - 基于 Debian Trixie 重新构建。
• 12.07.25: - 基于 Selkies 重新构建，向启动器添加无沙箱模式，现在需要 HTTPS。
• 03.04.25: - 更新 Chromium 启动选项以提高性能。
• 18.06.24: - 修复 Kasm 的应用初始化问题。
• 06.04.24: - 初始发布。