把本地项目放到阿里云服务器,只完成了部署的一部分。代码上传后,还要确认文件位置、运行环境、服务状态和网络端口;其中任何一项没配好,网站都可能打不开。下面按常见的 Linux 服务器场景,介绍 SCP、SFTP 和 Git 三种上传方式,并用 Node.js 项目说明上线时要检查哪些环节。
上传前先确认服务器和运行环境
轻量应用服务器和云服务器 ECS 都可以通过 SSH 管理。Linux 服务器通常使用密钥或用户名、密码登录,Windows 服务器则常通过远程桌面连接。系统不同,命令和目录也会有差异,本文的命令以 Linux 为例。
- 确认公网连接:在阿里云控制台查看实例的公网 IP 和运行状态。连接时使用这个 IP,不要误填内网地址。
- 检查安全组:SSH 通常使用 22 端口,网站一般按需开放 80 或 443 端口。只开放业务需要的端口,不要为了省事放开所有端口。
- 备好登录信息:确认用户名、密码或 SSH 密钥,并查清项目要求的 PHP、Node.js、Python 等运行环境版本。
SSH 连不上时,先核对公网 IP、用户名和密钥,再检查安全组是否允许你的客户端 IP 访问 SSH 端口。私钥应保存在本地安全位置,不要上传到服务器,也不要提交到代码仓库。
用 SCP 命令上传项目目录
SCP 通过 SSH 传输文件,适合上传少量文件或整个项目目录。在 macOS 或 Linux 的终端中,可以这样操作:
scp -i ~/.ssh/my-key.pem -r ./my-project user@服务器公网IP:/home/user/
-i后面填写私钥路径,-r表示复制整个目录;将user换成服务器用户名,并把最后的路径改成服务器上的目标目录。首次连接时,终端可能会询问是否信任服务器指纹。确认 IP 无误后再接受,避免连到错误的主机。
文件传完后,用 SSH 登录服务器,执行ls检查项目目录和文件是否在预期位置。遇到权限不足,先确认目标目录属于哪个用户。通常可以先上传到自己的用户目录,再根据项目需要调整文件归属和权限,不必长期用 root 账号操作。
用 SFTP 客户端拖拽文件
不习惯命令行的话,可以使用支持 SFTP 的客户端。新建连接时选择 SFTP,填写服务器公网 IP、SSH 端口、用户名和认证方式。连接后,通常左侧显示本地文件,右侧显示服务器目录,把项目拖到确认过的目标位置即可。
使用密钥登录时,客户端可能要求导入密钥,或将密钥转换成它支持的格式。连接失败时,检查密钥、端口和用户名是否正确。SFTP 对临时上传静态页面、配置文件或调试版本很方便;如果经常手动覆盖正式环境,容易传错目录或误覆盖正在运行的文件。操作前先核对远端路径,重要文件先备份。
通过 Git 拉取和更新代码
代码已经托管在 Git 平台时,可以在服务器上安装 Git,再进入部署目录执行:
git clone 仓库地址
项目已有本地副本后,进入项目目录执行git pull获取更新。私有仓库需要配置访问方式,例如 SSH 部署密钥或平台提供的访问令牌。不要把令牌直接写进公开脚本,也不要将密钥文件提交到仓库。
Git 能管理代码版本,但不会自动安装依赖、重启服务或迁移数据库。更新前先确认当前分支和提交记录,再按项目文档完成构建、测试及部署。正式环境不宜只凭“拉取成功”就认定更新已完成。
Node.js 项目上传后的部署示例
假设本地项目目录名为my-site,服务器运行 Linux。先用 SCP 上传到服务器用户目录:
scp -i ~/.ssh/my-key.pem -r ./my-site user@服务器公网IP:/home/user/
然后通过 SSH 登录,进入项目目录,查看项目说明文件。按照项目要求安装合适版本的 Node.js;如果项目使用 npm,再执行npm install安装依赖,并运行项目提供的测试命令。确认应用能正常启动后,再配置对外访问。
假设应用监听 3000 端口,不代表要把 3000 端口直接开放给所有公网用户。常见做法是让 Nginx 监听 80 或 443 端口,再把请求转发到本机的应用端口。这样可以通过 Nginx 配置域名、HTTPS 和反向代理。上线前还要确认应用进程在服务器重启后能恢复运行,并查看日志排查启动或访问错误。
不同项目的启动命令和配置并不一样,应以项目文档和实际设置为准。部署时按“上传代码、安装依赖、运行测试、配置访问入口、检查日志”的顺序逐项确认,通常比直接照抄一条启动命令更容易定位问题。
上传完成后检查这几项
- 文件是否齐全:检查入口文件、配置文件和依赖清单是否在目标目录,尤其留意上传时是否漏掉隐藏文件。
- 权限是否合适:让程序能读取需要的文件即可,不要把所有文件都设为可写,也不要习惯性扩大权限。
- 敏感信息是否暴露:数据库密码、API 密钥和私钥不要放进公开目录或前端代码。生产配置文件也不应随手提交到公开仓库。
- 服务是否能访问:检查应用进程、Web 服务器配置和安全组规则,再从浏览器或命令行测试访问。
- 能否恢复旧版本:更新重要项目之前先备份,或用 Git 保留版本记录。新代码出错时,有回退办法会省去不少排查时间。
常见上传和访问问题
上传速度慢:先检查本地网络和服务器地域距离。项目里有大量小文件时,可以排除缓存、日志等无关目录,将剩余文件打包上传后再在服务器解压。
出现 Permission denied:检查当前用户是否有目标目录的写入权限,以及登录密钥是否正确。不要不了解影响就执行chmod 777,这会让文件权限过宽。
上传成功但网站打不开:分开检查应用是否启动、监听地址和端口是否正确、Nginx 配置是否生效,以及安全组是否开放 80 或 443 端口。可以先在服务器本机测试,再检查公网访问,按这个顺序更容易找到问题所在。
覆盖代码后页面还是旧内容:可能是应用没有重新加载、构建产物没有更新,也可能是浏览器或代理缓存。先查看服务日志和实际部署目录,再按项目要求重新构建或重启服务,不要只根据页面显示判断代码是否传成功。
按项目情况选择上传方式
临时传几个文件,用 SFTP 拖拽最直观;熟悉终端、需要快速复制目录,可以用 SCP;项目会持续更新并需要管理版本,适合通过 Git 拉取。无论用哪种方式,更新正式服务前都应先验证代码,保留备份,并检查日志和访问结果。
阿里云服务器上传代码之后,还要把目标目录、运行环境、服务配置和网络访问逐一核对。可以先拿一个小项目练习,确认每一步都能复现,再考虑自动构建和持续部署。