jointakahe/takahe-dev

Takahē 开发版本镜像

镜像概述

该镜像为开源ActivityPub社交网络服务器Takahē的开发版本Docker镜像，基于Takahē项目最新开发分支（如main分支）构建。包含最新未发布的功能改进、bug修复及开发特性，旨在为开发者提供便捷的本地开发与测试环境。重要提示：开发版本镜像稳定性未经验证，可能存在功能变动或兼容性问题，严禁用于生产环境。

核心功能与特性

• 基于最新开发代码：镜像构建自Takahē最新开发分支，集成最新未发布的功能、优化及修复。
• 开发环境优化：默认配置针对开发场景优化，包含详细调试日志、错误堆栈追踪及开发工具链。
• 依赖与工具集成：预装开发所需的依赖包、数据库客户端及代码检查工具，简化开发环境搭建流程。
• 配置兼容性：与生产版本镜像的配置结构保持兼容，支持无缝迁移开发配置至生产环境测试。
• 本地代码挂载支持：允许挂载本地Takahē源代码目录至容器，实现代码实时更新与热重载（需配合框架热重载机制）。

使用场景

• 功能开发：开发者基于镜像进行Takahē新功能开发、代码重构及模块扩展。
• 新特性测试：测试开发分支中的实验性特性，验证功能可用性与兼容性。
• 代码贡献：为Takahē项目贡献代码时，通过镜像快速搭建一致的开发环境，验证贡献内容。
• 问题复现与修复：针对开发阶段发现的bug，在镜像环境中复现并验证修复方案。

使用方法与配置说明

前提条件

• 已安装Docker Engine（推荐20.10+版本）
• 已安装Docker Compose（可选，用于管理多容器依赖）
• 网络环境可访问Docker镜像仓库及Takahē项目依赖资源

获取镜像

从Takahē官方镜像仓库拉取最新开发版本镜像：

bash
docker pull docker.xuanyuan.run/jointakahe/takahe:dev

基本使用（单容器模式）

通过docker run命令启动镜像（需提前部署PostgreSQL数据库，Takahē依赖该数据库）：

bash
docker run -d \
  --name takahe-dev \
  -p 8000:8000 \
  -e DATABASE_URL=postgresql://user:password@db-host:5432/takahe \
  -e SECRET_KEY=dev_secret_key_123 \
  -e DEBUG=True \
  -e ALLOWED_HOSTS=localhost,127.0.0.1 \
  -v /path/to/local/takahe/source:/app \  # 挂载本地源代码（可选）
  jointakahe/takahe:dev

参数说明：

• -p 8000:8000：映射容器8000端口至主机，用于访问Takahē Web界面及API。
• -e DATABASE_URL：PostgreSQL数据库连接URL，格式为postgresql://用户名:密码@数据库主机:端口/数据库名。
• -e SECRET_KEY：开发环境密钥，用于加密会话数据（开发环境可简化设置，生产环境需使用强密钥）。
• -e DEBUG=True：启用调试模式，输出详细错误信息及请求日志。
• -e ALLOWED_HOSTS：允许访问的主机名列表，开发环境通常配置为localhost,127.0.0.1。
• -v /path/to/local/takahe/source:/app：挂载本地Takahē源代码目录至容器/app路径，实现代码实时更新（需确保本地代码与镜像依赖版本匹配）。

多容器部署（推荐，使用Docker Compose）

通过Docker Compose管理Takahē及依赖的PostgreSQL数据库，创建docker-compose.yml文件：

yaml
version: '3.8'

services:
  db:
    image: docker.xuanyuan.run/postgres:15-alpine
    environment:
      POSTGRES_USER: takahe_dev
      POSTGRES_PASSWORD: takahe_dev_pass
      POSTGRES_DB: takahe_dev_db
    volumes:
      - postgres_data:/var/lib/postgresql/data
    ports:
      - "5432:5432"

  takahe:
    image: docker.xuanyuan.run/jointakahe/takahe:dev
    depends_on:
      - db
    ports:
      - "8000:8000"
    environment:
      DATABASE_URL: postgresql://takahe_dev:takahe_dev_pass@db:5432/takahe_dev_db
      SECRET_KEY: dev_secret_key_123
      DEBUG: "True"
      ALLOWED_HOSTS: localhost,127.0.0.1
      STATIC_URL: /static/
      MEDIA_URL: /media/
    volumes:
      - ./takahe-source:/app  # 挂载本地源代码（需提前克隆Takahē仓库至./takahe-source）
    command: python manage.py runserver 0.0.0.0:8000  # 启动Django开发服务器（热重载）

volumes:
  postgres_data:

启动服务：

bash
docker-compose up -d

初始化与验证

数据库迁移

首次启动后，需执行数据库迁移以创建表结构：

bash
docker-compose exec takahe python manage.py migrate

创建超级用户

创建管理员账户以访问管理界面：

bash
docker-compose exec takahe python manage.py createsuperuser

根据提示输入用户名、***及密码。

访问服务

服务启动后，通过以下地址访问：

• Web界面：http://localhost:8000
• 管理后台：http://localhost:8000/admin（使用超级用户账户登录）

注意事项

• 数据持久化：开发环境默认使用临时卷存储数据，如需保留开发数据，需配置持久化存储（如示例中postgres_data卷）。
• 依赖更新：开发分支依赖可能频繁变动，建议定期拉取最新镜像并更新本地代码：

  bash
  docker pull docker.xuanyuan.run/jointakahe/takahe:dev
  git -C ./takahe-source pull origin main  # 同步本地代码至最新开发分支
  

• 网络隔离：开发环境建议限制容器网络访问范围，避免暴露敏感端口至公网。

相关资源

• https://github.com/jointakahe/takahe
• Takahē开发文档
• https://hub.docker.com/r/jointakahe/takahe