概述
本教程将教你如何从 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