手把手教你用阿里云轻量服务器搭建私有Composer仓库

嘿，兄弟们！今天咱们来聊点硬核但超实用的干货——怎么在阿里云的轻量应用服务器上，从零开始搭建一个属于你自己的私有 Composer 仓库。别一听“私有仓库”就觉得高大上、难搞，其实只要你跟着我的节奏一步步来，别说搭建了，你还能顺带把版本管理、团队协作这些流程都优化一遍。

先说说为啥要搞这个？如果你是个 PHP 开发者，或者你们团队在做多个项目，经常要用到自己封装的包（比如通用工具类、内部 SDK），那你就知道每次改完代码还得手动复制粘贴、或者上传到 GitHub 再 require，烦不烦？更别说有些代码不能公开，放公网上心里慌得一批。这时候，一个私有的 Composer 包管理仓库就显得特别香了。

而阿里云的轻量应用服务器（Lighthouse）简直就是这种场景的完美选择——价格便宜、配置简单、网络稳定，关键是部署起来飞快。5分钟开个服务器，半小时搭好环境，一天之内就能让你的团队用上专属的包管理服务。

为啥选阿里云轻量服务器？

首先咱得讲明白，为啥非得是阿里云的轻量服务器？不是说 AWS 或者腾讯云不行，而是对于大多数中小型开发者、初创团队来说，轻量服务器真的太友好了。

它不像 ECS 那样需要你懂一堆 VPC、安全组、负载均衡……轻量服务器默认给你配好了基础网络、防火墙规则，甚至连 LNMP 环境都能一键安装。你要做的，就是登录后台，点几下鼠标，然后 SSH 连上去开始干活。

而且价格也感人，最低几十块钱一个月，带公网 IP、流量包、DDoS 防护，跑个 Composer 私有仓库绰绰有余。重点是——现在新用户还有大额优惠券可以领！点击这里领取阿里云优惠券，能省不少钱，尤其是你要多开几台测试机的时候，这波羊毛不薅白不薅。

准备工作：你需要啥？

在动手之前，先把家伙事儿准备好：

• 一台阿里云轻量应用服务器（推荐 Ubuntu 20.04 或 22.04）
• 一个域名（可选，但建议有，方便后续 HTTPS）
• Composer 工具（本地和服务器都要装）
• 基本的 Linux 操作能力（会用 vim、ssh、apt 就行）

服务器系统我建议选 Ubuntu，因为软件源丰富，社区支持好，出问题也好搜解决方案。至于配置，1核2G 完全够用，毕竟这不是跑数据库或高并发服务，只是个包管理接口，轻轻松松。

第一步：买服务器 + 登录环境

打开阿里云官网，搜“轻量应用服务器”，选个合适的套餐。我一般直接上 1年 的套餐，算下来单价最低。选好之后付款，几分钟内就能看到实例状态变成“运行中”。

然后点击“连接”按钮，可以用网页版终端直接登录，也可以复制公网 IP 用本地终端 ssh 登录。比如：

ssh root@你的公网IP

第一次登录记得改密码，安全第一。顺便更新一下系统：

sudo apt update && sudo apt upgrade -y

第二步：安装 Nginx 和 PHP

我们的私有 Composer 仓库本质上是一个 Web 接口，用来响应 composer install 的请求。所以得有个 Web 服务器。Nginx 轻量又高效，搭配 PHP-FPM 刚刚好。

先装 Nginx：

sudo apt install nginx -y

再装 PHP 及相关扩展：

sudo apt install php-fpm php-cli php-zip php-mbstring php-curl -y

启动并设置开机自启：

sudo systemctl start nginx
sudo systemctl enable nginx
sudo systemctl start php7.4-fpm  # 根据你装的版本调整
sudo systemctl enable php7.4-fpm

现在打开浏览器访问你的服务器 IP，如果看到“Welcome to nginx!”说明 Web 服务已经跑起来了。

第三步：安装 Satis —— 私有仓库的核心

Satis 是 Composer 官方推荐的私有包构建工具，简单说就是：你告诉它哪些 Git 仓库要打包，它就生成一个 composer.json 可用的静态网站。

在服务器上创建一个目录专门放 Satis：

mkdir /var/www/satis && cd /var/www/satis

用 Composer 全局安装 satis（如果没有 composer，先装一下）：

curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer

然后初始化 Satis 项目：

composer init
composer require composer/satis

第四步：配置 satis.json

在 `/var/www/satis` 目录下创建 `satis.json` 文件：

vim satis.json

内容长这样：

{
    "name": "我的私有包仓库",
    "homepage": "http://你的域名或IP",
    "repositories": [
        {
            "type": "vcs",
            "url": "https://github.com/你的用户名/你的私有包"
        }
        // 可以继续加其他仓库
    ],
    "require-all": true,
    "output-dir": "web"
}

解释一下：

• homepage：就是别人访问你仓库的地址
• repositories：列出你要包含的 Git 仓库，支持 GitHub、GitLab、甚至是公司内网的 Git 服务
• require-all：表示把所有分支和标签都打包进去，方便切换版本
• output-dir：生成的静态文件放哪，我们设为 web

第五步：生成静态包列表

运行命令生成仓库页面：

php bin/satis build satis.json .

执行完你会发现多了个 web 目录，里面有一堆 json 文件，最关键的是 packages.json，这就是 Composer 能识别的索引文件。

第六步：配置 Nginx 访问

为了让外网能访问到这个仓库，我们要配置 Nginx 把请求指向 web 目录。

创建站点配置：

sudo vim /etc/nginx/sites-available/satis

写入：

server {
    listen 80;
    server_name 你的域名或IP;
    root /var/www/satis/web;
    index index.html;
    location / {
        try_files $uri $uri/ =404;
    }
}

然后启用这个配置：

sudo ln -s /etc/nginx/sites-available/satis /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx

现在再访问你的 IP 或域名，应该就能看到一堆 JSON 文件列表了。虽然丑了点，但它可是你私有包的心脏！

第七步：本地项目如何使用？

回到你的本地 PHP 项目，在 composer.json 里加上仓库地址：

"repositories": [
    {
        "type": "composer",
        "url": "http://你的服务器IP"
    }
],
"require": {
    "你的组织名/你的包名": "^1.0"
}

然后执行：

composer install

如果顺利拉下来包，恭喜你！你已经有了一个真正可用的私有 Composer 仓库了！

进阶建议：加个 HTTPS 更安全

现在仓库是 HTTP 的，虽然局域网用问题不大，但如果要给外部协作者用，还是建议上 HTTPS。你可以用阿里云免费的 SSL 证书，配合 Nginx 配置 HTTPS，这样传输更安全，也不会被浏览器警告。

可以把生成过程做成定时任务，比如每天凌晨自动 pull 最新代码并 rebuild 一次，确保团队总能拿到最新的包。

小投入，大回报

说实话，整个过程看起来步骤不少，但真正操作起来也就一两个小时的事。一旦搭好，你和你的团队就能告别手动更新、混乱依赖的问题，真正实现“像用 Laravel 那样优雅地引入自己的包”。

而且这套方案完全可控，数据在自己手里，不怕第三方服务突然收费或停服。再加上阿里云轻量服务器的稳定性，长期跑个这样的服务，几乎不用操心维护。

最重要的是——成本极低。一台轻量服务器一年几百块，换来的却是开发效率的成倍提升。别忘了，现在新用户还能领阿里云优惠券，首年可能只要几十块，简直白菜价。

别再犹豫了。今晚就去阿里云下单一台轻量服务器，照着这篇文章一步一步来。等你成功跑通第一条 composer require 的时候，你会感谢此刻点进来的自己。

有问题？评论区留言，我看到都会回。