快速开始

本指南将帮助您快速部署和配置 Daas Admin,包括环境准备、安装步骤和初始配置。

环境准备

在开始安装 Daas Admin 之前,请确保您的服务器或开发环境满足以下要求:

系统要求

  • 操作系统:Linux(推荐 Ubuntu 20.04+)、Windows Server 或 macOS
  • Node.js:v18.0.0 或更高版本
  • 数据库:MySQL 8.0+(推荐)或 PostgreSQL 12+(全栈尊享版)
  • Web 服务器:Nginx(推荐)或 Apache
  • 内存:最小 4GB RAM(推荐 8GB 或更多)
  • 存储:最小 20GB 可用空间

软件依赖

  • Git:用于代码版本控制和部署
  • npmyarn:Node.js 包管理器
  • PM2(可选):用于生产环境中的进程管理

提示

如果您使用云服务器,建议选择至少 2 核 CPU、4GB 内存的配置。对于高流量网站,可能需要更高配置。

安装步骤

方法一:使用安装包

  1. 下载安装包

    从官方网站下载最新版本的 Daas Admin 安装包。

    wget https://download.daas-admin.com/latest.zip unzip latest.zip
  2. 安装依赖

    进入解压后的目录,安装所需的依赖。

    cd daas-admin pnpm install
  3. 配置环境变量

    复制示例环境变量文件并进行配置。

    cp .env.example .env nano .env # 使用您喜欢的编辑器编辑配置
  4. 构建应用

    pnpm build
  5. 启动应用

    # 开发环境 pnpm dev # 生产环境 pnpm start # 使用 PM2(推荐用于生产环境) pm2 start pnpm --name "daas-admin" -- start

方法二:使用 Docker

  1. 安装 Docker 和 Docker Compose

    确保您的服务器已安装 Docker 和 Docker Compose。

  2. 下载 Docker 配置文件

    git clone https://github.com/daas-admin/docker-deploy.git cd docker-deploy
  3. 配置环境变量

    cp .env.example .env nano .env # 使用您喜欢的编辑器编辑配置
  4. 启动容器

    docker-compose up -d

初始配置

安装完成后,您需要进行一些初始配置才能开始使用 Daas Admin。

  1. 访问系统

    在浏览器中访问 http://your-server-ip:3000 或您配置的域名。

  2. 创建管理员账号

    首次访问系统时,您将被引导创建管理员账号。请设置安全的用户名和密码。

  3. 基本系统设置

    登录后,进入"设置"页面,配置以下基本信息:

    • 系统名称和 Logo
    • 默认语言和时区
    • 货币设置
    • 联系信息
  4. 配置支付方式

    进入"支付方式"页面,配置您需要的支付渠道,如支付宝、微信支付等。

  5. 创建产品

    进入"产品管理"页面,创建您的产品和价格。

恭喜!

完成以上步骤后,您的 Daas Admin 系统已经准备就绪,可以开始使用了。

生产环境部署

对于生产环境,我们推荐使用 Nginx + PM2 的组合来部署 Daas Admin,以获得更好的性能和可靠性。

使用 Nginx + PM2 部署

  1. 安装 PM2

    npm install -g pm2
  2. 使用 PM2 启动应用

    pm2 start pnpm --name "daas-admin" -- start
  3. 配置 Nginx 反向代理

    创建 Nginx 配置文件:

    server {
        listen 80;
        server_name your-domain.com;
    
        location / {
            proxy_pass http://localhost:3000;
            proxy_http_version 1.1;
            proxy_set_header Upgrade $http_upgrade;
            proxy_set_header Connection 'upgrade';
            proxy_set_header Host $host;
            proxy_cache_bypass $http_upgrade;
        }
    }
  4. 启用 Nginx 配置

    sudo ln -s /etc/nginx/sites-available/daas-admin.conf /etc/nginx/sites-enabled/
    sudo nginx -t
    sudo systemctl restart nginx
  5. 设置 PM2 开机自启

    pm2 startup
    pm2 save

性能优化提示

对于高流量网站,您可以考虑以下优化措施:

  • 启用 Nginx 缓存静态资源
  • 配置 PM2 集群模式以利用多核 CPU
  • 使用 CDN 加速静态资源的分发
  • 启用 Gzip 压缩减少传输数据量

常见问题

安装过程中遇到错误怎么办?

如果在安装过程中遇到错误,请检查以下几点:

  • 确保您的环境满足系统要求
  • 检查环境变量配置是否正确
  • 查看安装日志以获取详细错误信息
  • 参考 故障排除指南

如何更新到最新版本?

更新到最新版本的步骤如下:

  1. 备份当前系统数据
  2. 下载最新版本的系统包
  3. 停止当前运行的应用
  4. 替换文件(保留您的 .env 文件和自定义配置)
  5. 使用 pnpm install 安装依赖并使用 pnpm build 构建应用
  6. 启动应用

详细的更新指南请参考 升级文档

下一步