Linux on Izumi Konata

使用docker搭建本地知识库Outline 使用keycloak实现本地注册认证

Sun, 02 Nov 2025 00:00:00 +0000

Outline搭建

参考文献：docker基于本地存储部署outline团队知识库_outline部署

准备

安装docker、和 docker compose 插件

# 常规更新起手
sudo apt update

# 安装Docker
sudo apt install docker.io -y
sudo systemctl enable docker && sudo systemctl start docker
sudo usermod -aG docker $USER  # 授予当前用户Docker权限（需重新登录生效）

# 安装Docker Compose

sudo apt install docker-compose-plugin -y
# 验证安装：显示版本即成功
docker compose version

docker配置镜像源

# 创建配置文件
vim /etc/docker/daemon.json

# 粘贴下面内容
{
  "registry-mirrors": [
    "https://docker.1ms.run",
    "https://docker-0.unsee.tech",
    "https://docker.m.daocloud.io"
  ],
  "live-restore": true,
  "features": { "buildkit": true }
}

# 重启docker
systemctl daemon-reload
systemctl restart docker

部署

创建文件夹路径

# 创建文件路径
/
└── data/
    ├── keycloak
    │   └── docker-compose.yml
    └── outline
        ├── docker-compose.yml
        ├── docker.env
        └── redis.conf

keycloak/docker-compose.yml

name: 'keycloak'

networks:
  stack-network:
    external: true

volumes:
  keycloak-postgres:

services:
  postgres-keycloak:
    image: ${KEYCLOAK_POSTGRES_IMAGE_TAG}
    volumes:
      - keycloak-postgres:/var/lib/postgresql/data
    environment:
      POSTGRES_DB: ${KEYCLOAK_DB_NAME}
      POSTGRES_USER: ${KEYCLOAK_DB_USER}
      POSTGRES_PASSWORD: ${KEYCLOAK_DB_PASSWORD}
    networks:
      - stack-network
    healthcheck:
      test: [ "CMD", "pg_isready", "-q", "-d", "${KEYCLOAK_DB_NAME}", "-U", "${KEYCLOAK_DB_USER}" ]
      interval: 10s
      timeout: 5s
      retries: 3
      start_period: 60s
    restart: unless-stopped

  keycloak:
    image: ${KEYCLOAK_IMAGE_TAG}
    command: start-dev
    environment:
      KC_DB: postgres
      KC_DB_URL_HOST: postgres-keycloak
      KC_DB_URL_DATABASE: ${KEYCLOAK_DB_NAME}
      KC_DB_USERNAME: ${KEYCLOAK_DB_USER}
      KC_DB_PASSWORD: ${KEYCLOAK_DB_PASSWORD}
      KC_DB_SCHEMA: public
      KEYCLOAK_ADMIN: ${KEYCLOAK_ADMIN_USERNAME}
      KEYCLOAK_ADMIN_PASSWORD: ${KEYCLOAK_ADMIN_PASSWORD}
      KC_HEALTH_ENABLED: 'true'
      KC_HOSTNAME: ${KEYCLOAK_HOSTNAME}
      KC_HTTP_ENABLED: 'true'
      KC_PROXY_HEADERS: 'xforwarded'
      PROXY_ADDRESS_FORWARDING: 'true'
    ports:
      - "8080:8080"
    networks:
      - stack-network
    healthcheck:
      test:
      - "CMD-SHELL"
      - |
        exec 3<>/dev/tcp/localhost/9000 &&
        echo -e 'GET /health/ready HTTP/1.1\r\nHost: localhost\r\nConnection: close\r\n\r\n' >&3 &&
        cat <&3 | tee /tmp/healthcheck.log | grep -q '200 OK'
      interval: 10s
      timeout: 5s
      retries: 3
      start_period: 90s
    restart: unless-stopped
    depends_on:
      postgres-keycloak:
        condition: service_healthy

outline/docker-compose.yml

name: "outline"

networks:
  stack-network:
    external: true

services:

  outline:
    image: outlinewiki/outline:0.78.0
    env_file: ./docker.env
    networks:
      - stack-network
    ports:
      - "3000:3000"
    volumes:
      - storage-data:/var/lib/outline/data
    depends_on:
      - postgres
      - redis

  redis:
    image: redis:7-alpine
    env_file: ./docker.env
    networks:
      - stack-network
    ports:
      - "6379:6379"
    volumes:
      - ./redis.conf:/redis.conf
    command: ["redis-server", "/redis.conf"]
    healthcheck:
      test: ["CMD", "redis-cli", "ping"]
      interval: 10s
      timeout: 30s
      retries: 3

  postgres:
    image: postgres:16-alpine
    env_file: ./docker.env
    networks:
      - stack-network
    ports:
      - "5432:5432"
    volumes:
      - database-data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD", "pg_isready", "-d", "outline", "-U", "user"]
      interval: 30s
      timeout: 20s
      retries: 3
    environment:
      POSTGRES_USER: 'user'
      POSTGRES_PASSWORD: 'pass'
      POSTGRES_DB: 'outline'

volumes:
  storage-data:
  database-data:

outline/docker.env.txt

# –––––––––––––––– REQUIRED ––––––––––––––––

NODE_ENV=production

# Generate a hex-encoded 32-byte random key. You should use 33688ac543ce11e5a5e75627821bb72c9f175117b86a734d4421e9264ce6f35d
# in your terminal to generate a random value.
SECRET_KEY=98ea98adade7b6af8c4252651b195d4083c484b833b8e0e638623ae60cc7d24e

# Generate a unique random key. The format is not important but you could still use
# ad2d30c9b96ab4fbb192a8eb594215334bd93eea583453e8abfe2e1bb05802c7 in your terminal to produce this.
UTILS_SECRET=98ea98adade7b6af8c4252651b195d4083c484b833b8e0e638623ae60cc7d24e

# For production point these at your databases, in development the default
# should work out of the box.
DATABASE_URL=postgres://user:pass@postgres:5432/outline
DATABASE_CONNECTION_POOL_MIN=
DATABASE_CONNECTION_POOL_MAX=
# Uncomment this to disable SSL for connecting to Postgres
PGSSLMODE=disable

# For redis you can either specify an ioredis compatible url like this
REDIS_URL=redis://redis:6379
# or alternatively, if you would like to provide additional connection options,
# use a base64 encoded JSON connection option object. Refer to the ioredis documentation
# for a list of available options.
# Example: Use Redis Sentinel for high availability
# {"sentinels":[{"host":"sentinel-0","port":26379},{"host":"sentinel-1","port":26379}],"name":"mymaster"}
# REDIS_URL=ioredis://eyJzZW50aW5lbHMiOlt7Imhvc3QiOiJzZW50aW5lbC0wIiwicG9ydCI6MjYzNzl9LHsiaG9zdCI6InNlbnRpbmVsLTEiLCJwb3J0IjoyNjM3OX1dLCJuYW1lIjoibXltYXN0ZXIifQ==

# URL should point to the fully qualified, publicly accessible URL. If using a
# proxy the port in URL and PORT may be different.
URL=http://192.168.1.11:3000
PORT=3000

# See [documentation](docs/SERVICES.md) on running a separate collaboration
# server, for normal operation this does not need to be set.
COLLABORATION_URL=

# Specify what storage system to use. Possible value is one of "s3" or "local".
# For "local", the avatar images and document attachments will be saved on local disk. 
FILE_STORAGE=local

# If "local" is configured for FILE_STORAGE above, then this sets the parent directory under
# which all attachments/images go. Make sure that the process has permissions to create
# this path and also to write files to it.
FILE_STORAGE_LOCAL_ROOT_DIR=/var/lib/outline/data

# Maximum allowed size for the uploaded attachment.
FILE_STORAGE_UPLOAD_MAX_SIZE=262144000

# Override the maximum size of document imports, generally this should be lower
# than the document attachment maximum size.
FILE_STORAGE_IMPORT_MAX_SIZE=

# Override the maximum size of workspace imports, these can be especially large
# and the files are temporary being automatically deleted after a period of time.
FILE_STORAGE_WORKSPACE_IMPORT_MAX_SIZE=

# To support uploading of images for avatars and document attachments in a distributed 
# architecture an s3-compatible storage can be configured if FILE_STORAGE=s3 above.
AWS_ACCESS_KEY_ID=
AWS_SECRET_ACCESS_KEY=
AWS_REGION=
AWS_S3_ACCELERATE_URL=
AWS_S3_UPLOAD_BUCKET_URL=
AWS_S3_UPLOAD_BUCKET_NAME=
AWS_S3_FORCE_PATH_STYLE=
AWS_S3_ACL=

# –––––––––––––– AUTHENTICATION ––––––––––––––

# Third party signin credentials, at least ONE OF EITHER Google, Slack,
# or Microsoft is required for a working installation or you'll have no sign-in
# options.

# To configure Slack auth, you'll need to create an Application at
# => https://api.slack.com/apps
#
# When configuring the Client ID, add a redirect URL under "OAuth & Permissions":
# https://<URL>/auth/slack.callback
SLACK_CLIENT_ID=
SLACK_CLIENT_SECRET=

# To configure Google auth, you'll need to create an OAuth Client ID at
# => https://console.cloud.google.com/apis/credentials
#
# When configuring the Client ID, add an Authorized redirect URI:
# https://<URL>/auth/google.callback
GOOGLE_CLIENT_ID=
GOOGLE_CLIENT_SECRET=

# To configure Microsoft/Azure auth, you'll need to create an OAuth Client. See
# the guide for details on setting up your Azure App:
# => https://wiki.generaloutline.com/share/dfa77e56-d4d2-4b51-8ff8-84ea6608faa4
AZURE_CLIENT_ID=
AZURE_CLIENT_SECRET=
AZURE_RESOURCE_APP_ID=

# To configure generic OIDC auth, you'll need some kind of identity provider.
# See documentation for whichever IdP you use to acquire the following info:
# Redirect URI is https://<URL>/auth/oidc.callback
OIDC_CLIENT_ID=outline
OIDC_CLIENT_SECRET=zmnUeCs2gxqdNgakM7NcRqdBYnVX47gf
OIDC_AUTH_URI="http://192.168.1.11:8080/realms/outline/protocol/openid-connect/auth"
OIDC_TOKEN_URI="http://192.168.1.11:8080/realms/outline/protocol/openid-connect/token"
OIDC_USERINFO_URI="http://192.168.1.11:8080/realms/outline/protocol/openid-connect/userinfo"
OIDC_LOGOUT_URI=

# Specify which claims to derive user information from
# Supports any valid JSON path with the JWT payload
OIDC_USERNAME_CLAIM=preferred_username

# Display name for OIDC authentication
OIDC_DISPLAY_NAME=keycloak

# Space separated auth scopes.
OIDC_SCOPES=openid profile email

# To configure the GitHub integration, you'll need to create a GitHub App at
# => https://github.com/settings/apps
#
# When configuring the Client ID, add a redirect URL under "Permissions & events":
# https://<URL>/api/github.callback
GITHUB_CLIENT_ID=
GITHUB_CLIENT_SECRET=
GITHUB_APP_NAME=
GITHUB_APP_ID=
GITHUB_APP_PRIVATE_KEY=

# To configure Discord auth, you'll need to create a Discord Application at
# => https://discord.com/developers/applications/
#
# When configuring the Client ID, add a redirect URL under "OAuth2":
# https://<URL>/auth/discord.callback
DISCORD_CLIENT_ID=
DISCORD_CLIENT_SECRET=

# DISCORD_SERVER_ID should be the ID of the Discord server that Outline is
# integrated with. 
# Used to verify that the user is a member of the server as well as server
# metadata such as nicknames, server icon and name.
DISCORD_SERVER_ID=

# DISCORD_SERVER_ROLES should be a comma separated list of role IDs that are
# allowed to access Outline. If this is not set, all members of the server
# will be allowed to access Outline.
# DISCORD_SERVER_ID and DISCORD_SERVER_ROLES must be set together.
DISCORD_SERVER_ROLES=

# –––––––––––––––– OPTIONAL ––––––––––––––––

# Base64 encoded private key and certificate for HTTPS termination. This is only
# required if you do not use an external reverse proxy. See documentation:
# https://wiki.generaloutline.com/share/1c922644-40d8-41fe-98f9-df2b67239d45
SSL_KEY=
SSL_CERT=

# If using a Cloudfront/Cloudflare distribution or similar it can be set below.
# This will cause paths to javascript, stylesheets, and images to be updated to
# the hostname defined in CDN_URL. In your CDN configuration the origin server
# should be set to the same as URL.
CDN_URL=

# Auto-redirect to https in production. The default is true but you may set to
# false if you can be sure that SSL is terminated at an external loadbalancer.
FORCE_HTTPS=false

# Have the installation check for updates by sending anonymized statistics to
# the maintainers
ENABLE_UPDATES=true

# How many processes should be spawned. As a reasonable rule divide your servers
# available memory by 512 for a rough estimate
WEB_CONCURRENCY=1

# You can remove this line if your reverse proxy already logs incoming http
# requests and this ends up being duplicative
DEBUG=http

# Configure lowest severity level for server logs. Should be one of
# error, warn, info, http, verbose, debug and silly
LOG_LEVEL=info

# For a complete Slack integration with search and posting to channels the
# following configs are also needed, some more details
# => https://wiki.generaloutline.com/share/be25efd1-b3ef-4450-b8e5-c4a4fc11e02a
#
SLACK_VERIFICATION_TOKEN=
SLACK_APP_ID=
SLACK_MESSAGE_ACTIONS=

# For Dropbox integration, follow these instructions to get the key https://www.dropbox.com/developers/embedder#setup
# and do not forget to whitelist your domain name in the app settings
DROPBOX_APP_KEY=

# Optionally enable Sentry (sentry.io) to track errors and performance,
# and optionally add a Sentry proxy tunnel for bypassing ad blockers in the UI:
# https://docs.sentry.io/platforms/javascript/troubleshooting/#using-the-tunnel-option)
SENTRY_DSN=
SENTRY_TUNNEL=

# To support sending outgoing transactional emails such as "document updated" or
# "you've been invited" you'll need to provide authentication for an SMTP server
SMTP_HOST=
SMTP_PORT=
SMTP_USERNAME=
SMTP_PASSWORD=
SMTP_FROM_EMAIL=
SMTP_REPLY_EMAIL=
SMTP_TLS_CIPHERS=
SMTP_SECURE=true

# The default interface language. See translate.getoutline.com for a list of
# available language codes and their rough percentage translated.
DEFAULT_LANGUAGE=en_US

# Optionally enable rate limiter at application web server
RATE_LIMITER_ENABLED=true

# Configure default throttling parameters for rate limiter
RATE_LIMITER_REQUESTS=1000
RATE_LIMITER_DURATION_WINDOW=60

# Iframely API config
#IFRAMELY_URL=
#IFRAMELY_API_KEY=

启动

# 移动到 有 docker-compose.yml文件的路径下

# 启动 keycloak
cd /data/keycloak
# 启动
docker compose up -d

# 启动outline
cd /data/outline
# 启动
docker compose up -d

# 停止
docker compose down

Ubuntu-service-2024使用k3s搭建kubernetes

Fri, 19 Sep 2025 00:00:00 +0000

Ubuntu-service-2024使用k3s搭建kubernetesk3s

安装&使用

# 国内镜像源安装
curl -sfL https://rancher-mirror.rancher.cn/k3s/k3s-install.sh | INSTALL_K3S_MIRROR=cn sh -s - \
--system-default-registry "registry.cn-hangzhou.aliyuncs.com"

# 卸载
sudo k3s-uninstall.sh

# 检查, 要多等一会
kubectl get nodes
kubectl get pod -A # 查看是不是都是 0/1, 如果只有1个就没问题

# docker镜像导出为 tar文件, 要确保导出前的镜像可用
docker save test -o test.tar
# 导入 ctr , 这样 kubenetes 就可以用本地镜像了
sudo k3s ctr image import test.tar
# 查看 ctr 里的镜像
sudo k3s ctr image list

# 启动并公开服务给集群外部访问
# 命令创建 deployment, --port 表示deploy服务端口为80
sudo kubectl create deployment nginx --image=base_images/base_nginx --port 80
# 查看
sudo kubectl get all
# 启动service , 类型为 NodePort, --target-port=80 是deploy服务所在端口, --node-port=30080就是service对集群外提供服务的端口
sudo kubectl expose deployment base-nginx --type=NodePort --port=80 --target-port=80 --name=base-nginx-service --node-port=30080
# 查看
sudo kubectl get all

# 启动完,可能 netstat 查看不到 service 监听的端口, 但是可以正常访问
sudo kubectl get svc -o wide

Ubuntu-service-2024使用minicube搭建kubernetes

Fri, 19 Sep 2025 00:00:00 +0000

Ubuntu-service-2024使用minicube搭建kubernetes

minikube下载安装

官方文档

常用命令

# 检查 minikube 状态
minikube status
# 查看集群信息
minikube kubectl --  cluster-info
# 查看节点信息
minikube kubectl --  get nodes
# 进入 minikube 环境
minikube ssh
# 检查集群状态
minikube status
# 查看所有 Pod
minikube kubectl --  get pods
# 查看 Pod 日志
minikube kubectl --  logs <pod-name>

一般查看官方文档就行,下面是我遇到的问题和解决方案

环境: 2核4G的Ubuntu虚拟机, 驱动是docker 下面是启动脚本

#!/bin/bash
#
export HTTP_PROXY=http://your-proxy:port
export HTTPS_PROXY=http://your-proxy:port
# 使用阿里云镜像启动 minikube, 不过好像没什么用, 不加代理还是不行
minikube start --driver=docker \
  --image-mirror-country='cn' \
  --image-repository='registry.cn-hangzhou.aliyuncs.com/google_containers' \
  --memory=2048mb \
  --cpus=2 \
  --force

无法访问docker的权限问题导致启动失败

解决方案:

# 1.将当前用户添加到 docker 组
sudo usermod -aG docker $USER
# 退出当前会话并重新登录，或者使用以下命令立即生效
newgrp docker

# 2.使用root用户启动

# 3.不使用docker驱动, 可以直接在主机运行或者使用 kvm的等
# 加上参数 
--driver=none 	#直接在物理机运行kubernetes ctl
--driver=kvm	#使用kvm替代docker

docker驱动时,第一次启动需要拉取镜像的网络问题

解决方案:

1
2
3

# 加代理
export HTTP_PROXY=http://your-proxy:port
export HTTPS_PROXY=http://your-proxy:port

未安装虚拟机驱动导致minikube start 报错 Exiting due to DRV_NOT_DETECTED

1
2

# 安装 KVM 如 Ubuntu：
sudo apt install qemu-kvm

资源不足导致启动失败

# 调整资源分配, 看自己情况给多或者给少一些
minikube config set memory 4096  # 分配 4GB 内存
minikube config set cpus 2       # 分配 2 核 CPU
minikube delete && minikube start

未清理旧集群, 多次启动失败后残留配置冲突

1
2

# 彻底删除旧集群
minikube delete --all --purge

运行第一个 Kubernetes 应用

# 部署 Nginx 服务, 需要docker里有nginx镜像
minikube kubectl -- create deployment fuzzing --image=fuzzing

# --port=8000 指要监听容器的80端口, 也就是镜像提供服务的端口
minikube kubectl -- create deployment fuzzing --image=utibetctf/fuzzing --port=80

# --port=8000 service的端口
# --target-port 80 转发到 Pod 的哪个端口
minikube kubectl --  expose deployment fuzzing --type=NodePort --port=8000 --target-port 80

# 访问服务
minikube service nginx
# 查看 Service 详情
minikube kubectl --  get service fuzzing -o wide

# 删除
# 首先查看所有资源
minikube kubectl --  get all --show-labels
# 根据显示的资源名称精确删除
minikube kubectl --  delete deployment/<name> service/<name>

Ubuntu-service-2024安装docker和docker-compose

Tue, 02 Sep 2025 00:00:00 +0000

Ubuntu-service-2024安装docker

Ubuntu官方下载

检查并卸载老版本

`1`	`sudo apt-get remove docker docker-engine docker.io containerd runc`

安装新版本

# 常规更新起手
sudo apt update

# 安装docker依赖
# Docker在Ubuntu上依赖一些软件包。执行以下命令来安装这些依赖
sudo apt-get install ca-certificates curl gnupg lsb-release

# 添加Docker官方GPG密钥
curl -fsSL http://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg | sudo apt-key add -

# 添加Docker软件源
sudo add-apt-repository "deb [arch=amd64] http://mirrors.aliyun.com/docker-ce/linux/ubuntu $(lsb_release -cs) stable"

# 安装docker引擎
sudo apt update
sudo apt install docker-ce docker-ce-cli containerd.io docker-compose-plugin

# 配置用户组（可选,推荐）
# 默认情况下，只有root用户和docker组的用户才能运行Docker命令。我们可以将当前用户添加到docker组，以避免每次使用Docker时都需要使用sudo。

# 将当前用户添加到 docker 组
sudo usermod -aG docker $USER

# 退出当前会话并重新登录，或者使用以下命令立即生效
newgrp docker

# 启动docker并且配置开机启动
sudo systemctl start docker
sudo systemctl status docker
sudo systemctl enable docker

pip 安装 docker-compose

# 更新pip
pip3 install --upgrade pip -i https://pypi.tuna.tsinghua.edu.cn/simple

#安装 docker-compose：
pip3 install docker-compose -i https://pypi.tuna.tsinghua.edu.cn/simple

# 检查安装
docker-compose version

Ubuntu-service-2024安装miniconda管理python环境

Tue, 02 Sep 2025 00:00:00 +0000

安装miniconda

# 下载
wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh

# 加执行权限
chmod +x Miniconda3-latest-Linux-x86_64.sh

# 运行
./Miniconda3-latest-Linux-x86_64.sh
# 建议conda init 选 yes

# 然后退出终端, 重新连接,加载环境变量或者
source ~./bashrc  # 注意这一步要在bash环境,不能是fish之类的

conda管理python虚拟环境

conda换源

# conda 换源
# 添加清华源
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main/
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free/
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/r/
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/msys2/
conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/conda-forge/

# 设置显示源地址
conda config --set show_channel_urls yes

# 移除默认源（可选）
conda config --remove channels defaults

管理虚拟环境

# 创建名为 MyEnvName 的 3.11 版本的python
conda create -n MyEnvName python=3.11

# 删除虚拟环境
conda remove MyEnvName

虚拟环境中pip换源

# 激活虚拟环境
conda activate MyEnvName 
# 在bash环境中激活, 激活成功后可以启动fish等,也是激活状态

# pip 换源
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
pip config set global.trusted-host pypi.tuna.tsinghua.edu.cn