首页
/ Dolphin 安装与配置指南

Dolphin 安装与配置指南

2025-04-19 12:43:59作者:舒璇辛Bertina

1. 项目基础介绍

Dolphin 是一个轻量级的 ActivityPub 服务器,适用于个人或团队使用。它是 Misskey 项目的分支,继承了 Misskey 项目的反应功能和高效性能,并针对单用户使用进行了优化,使得它更加易于使用且占用资源更少。

项目主要使用的编程语言是 TypeScript 和 Vue。

2. 项目使用的关键技术和框架

  • TypeScript: 提供了类型系统和编译时类型检查,使得代码更加健壮。
  • Vue: 用于构建用户界面的渐进式JavaScript框架。
  • Node.js: 服务器端的JavaScript运行环境。
  • ActivityPub: 一种用于去中心化社交网络的协议。
  • PostgreSQL: 一种功能强大的开源对象关系型数据库系统。
  • Redis: 一个开源的内存数据结构存储系统,用作数据库、缓存和消息代理。

3. 安装和配置准备工作

在开始安装之前,请确保您的系统已经安装以下软件:

  • Node.js(版本 >= 11.7.0)
  • PostgreSQL(版本 >= 10)
  • Redis

安装步骤

  1. 创建 Dolphin 用户

    运行以下命令创建一个新的用户,不建议以 root 用户运行 Dolphin:

    adduser --disabled-password --disabled-login dolphin
    
  2. 安装依赖

    以 Dolphin 用户身份安装必要的依赖:

    su - dolphin
    

    克隆 Dolphin 仓库:

    git clone -b master git://github.com/syuilo/dolphin.git
    

    切换到 Dolphin 目录:

    cd dolphin
    

    安装 Dolphin 依赖:

    npm i
    
  3. 配置 Dolphin

    复制配置文件:

    cp .config/example.yml .config/default.yml
    

    编辑配置文件(例如使用 vim):

    vim .config/default.yml
    
  4. 构建 Dolphin

    使用以下命令构建 Dolphin:

    NODE_ENV=production npm run build
    

    如果在 Debian 系统上遇到错误,可能需要安装 build-essentialpython 包。

    如果遇到模块相关的错误,使用 node-gyp 进行配置和构建:

    npx node-gyp configure
    npx node-gyp build
    NODE_ENV=production npm run build
    
  5. 初始化数据库

    运行以下命令初始化数据库:

    npm run init
    
  6. 启动 Dolphin

    使用以下命令启动 Dolphin:

    NODE_ENV=production npm start
    

    祝贺您,Dolphin 现在应该已经运行在您的服务器上了!

遵循以上步骤,即使是编程小白也能够顺利安装和配置 Dolphin 项目。如果有任何疑问,请查阅项目的官方文档或社区论坛。

登录后查看全文
热门项目推荐