ByteStash部署完整指南：自托管代码片段管理库搭建教程

November 27, 2025

ByteStash是一款自托管的Web应用程序，专门用于高效存储、组织和维护代码片段。它支持代码片段的创建、编辑和过滤操作，帮助用户在一个安全可靠的环境中追踪和管理代码资源。

详细安装步骤

通过Docker Compose进行部署，以下为配置示例：

services:  
bytestash:  
    image: ghcr.io/jordan-dalby/bytestash:latest  
    container_name: bytestash  
    ports:  
      - 5000:5000  
    environment:  
      - BASE-PATH=  
      - JWT-SECRET=your-secret  
      - TOKEN-EXPIRY=24h  
      - ALLOW-NEW-ACCOUNTS=true  
      - DEBUG=true  
      - DISABLE-ACCOUNTS=false  
      - DISABLE-INTERNAL-ACCOUNTS=false  
      - OIDC-ENABLED=false  
      - OIDC-DISPLAY-NAME=  
      - OIDC-ISSUER-URL=  
      - OIDC-CLIENT-ID=  
      - OIDC-CLIENT-SECRET=  
      - OIDC-SCOPES=  
    volumes:  
      - ./snippets:/data/snippets  
    restart: always

环境变量参数说明（建议参考官方文档获取更多细节）：

ALLOWED_HOSTS（环境变量）：指定允许访问的主机列表。

BASE_PATH（环境变量）：用于设置应用程序的基础路径，默认值为空字符串。

JWT_SECRET（环境变量）：用于JWT加密的密钥，需替换为自定义生成的字符串。

TOKEN_EXPIRY（环境变量）：设置JWT令牌的有效期限。

ALLOW_NEW_ACCOUNTS（环境变量）：控制是否允许新用户注册账户。

DEBUG（环境变量）：启用或禁用调试模式。

DISABLE_ACCOUNTS（环境变量）：决定是否关闭账号系统，包括登录和注册功能。

DISABLE_INTERNAL_ACCOUNTS（环境变量）：设置是否禁用内部账号系统，仅支持OIDC等外部认证方式。

OIDC_ENABLED（环境变量）：启用或停用OIDC认证功能。

OIDC_DISPLAY_NAME（环境变量）：在登录界面显示的OIDC认证名称。

OIDC_ISSUER_URL（环境变量）：OIDC提供商的发行者URL地址。