销售:050-1791-1110

如何部署开源项目

概述

本教程将教你如何从 GitHub 获取开源项目并部署到你自己的服务器上。我们以一个典型的 Node.js 项目为例,从克隆代码到上线运行,一步步完成。

准备工作

  • 一台 Linux 服务器(推荐 Ubuntu 22.04/24.04)
  • 已安装 Git、Node.js(或对应运行时)
  • 基本的命令行操作能力

步骤一:克隆项目

# 克隆仓库到服务器
git clone https://github.com/example/awesome-project.git
cd awesome-project

步骤二:安装依赖

# Node.js 项目
npm install

# Python 项目
pip install -r requirements.txt

# PHP 项目
composer install

步骤三:配置环境变量

# 复制示例配置文件
cp .env.example .env

# 编辑配置,填入数据库地址、密钥等
nano .env

常见需要配置的项:

  • DATABASE_URL — 数据库连接字符串
  • SECRET_KEY — 应用密钥(随机生成一个长字符串)
  • PORT — 监听端口

步骤四:构建与运行

# 构建生产版本
npm run build

# 直接运行
npm start

# 或使用 PM2 守护进程
npm install -g pm2
pm2 start npm --name "my-app" -- start
pm2 save
pm2 startup

步骤五:配置反向代理

使用 Nginx 将域名指向你的应用:

server {
    listen 80;
    server_name app.example.com;

    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

步骤六:申请 SSL 证书

sudo apt install certbot python3-certbot-nginx
sudo certbot --nginx -d app.example.com

常见问题

  • 端口被占用? 使用 lsof -i :3000 查看并 kill 相关进程
  • 权限不足? 确保项目目录归属正确,不要用 root 运行应用
  • 内存不够? 添加 Swap 分区:sudo fallocate -l 2G /swapfile
滚动至顶部