Ubuntu 20.04 云服务器安装JDK 17完整教程
📋 文章摘要
本文详细介绍在腾讯云轻量应用服务器（Ubuntu 20.04 LTS）上手动安装Oracle JDK 17的完整过程。包括安装包上传、解压、环境变量配置、验证安装等关键步骤，以及常见问题的解决方案。
关键词：JDK 17、Ubuntu、云服务器、Java环境配置、环境变量
🖥️ 环境说明
- 服务器：腾讯云轻量应用服务器
- 操作系统：Ubuntu 20.04 LTS
- JDK版本：Oracle JDK 17.0.16
- 安装方式：手动安装（tar.gz包）
📚 目录
1. 准备工作
1.1 下载JDK 17安装包
从Oracle官网下载JDK 17安装包：
- 下载地址：https://www.oracle.com/java/technologies/downloads/#java17
- 选择：Linux x64 Compressed Archive（.tar.gz格式）
- 文件名示例：
jdk-17.0.16_linux-x64_bin.tar.gz
1.2 创建安装目录
# 创建JDK安装目录sudomkdir -p /opt/java # 修改目录权限（允许当前用户写入）sudochown -R ubuntu:ubuntu /opt/java sudochmod -R 755 /opt/java 说明：
/opt/java：JDK的标准安装位置- 修改权限后，可以通过文件管理器上传文件
2. 上传JDK安装包
方式一：使用文件管理器上传（推荐）
- 登录云服务器控制台
- 进入文件管理器
- 导航到
/opt/java目录 - 上传JDK安装包（.tar.gz文件）
注意：如果提示"无写权限"，执行以下命令修复：
sudochown -R ubuntu:ubuntu /opt/java sudochmod -R 755 /opt/java 方式二：使用SCP命令上传
在本地电脑执行：
scp /path/to/jdk-17.0.16_linux-x64_bin.tar.gz ubuntu@服务器IP:/opt/java/ 方式三：使用wget直接下载
cd /opt/java wget https://download.oracle.com/java/17/latest/jdk-17_linux-x64_bin.tar.gz 3. 解压JDK安装包
3.1 进入安装目录
cd /opt/java ls -la 预期输出：应该看到JDK安装包文件
3.2 解压安装包
# 解压JDK安装包tar -xzf jdk-17.0.16_linux-x64_bin.tar.gz # 查看解压后的目录ls -la 预期结果：会看到类似 jdk-17.0.16 的目录
重要：记录解压后的实际目录名，后续配置环境变量需要使用。
3.3 验证解压结果
# 查看JDK目录结构ls -la jdk-17.0.16/ # 应该看到以下目录：# bin/ conf/ include/ jmods/ legal/ lib/ release4. 配置环境变量
4.1 编辑系统配置文件
# 编辑系统级配置文件（所有用户生效）sudovi /etc/profile 4.2 添加JDK环境变量
在文件末尾添加以下内容：
# JDK 17 环境变量配置exportJAVA_HOME=/opt/java/jdk-17.0.16 exportJRE_HOME=$JAVA_HOME/jre exportCLASSPATH=.:$JAVA_HOME/lib:$JRE_HOME/lib exportPATH=$JAVA_HOME/bin:$PATH重要说明：
- 将
/opt/java/jdk-17.0.16替换为你实际的JDK目录名 - 如果解压后是其他名称，相应修改路径
4.3 保存并退出
- 按
Esc退出编辑模式 - 输入
:wq保存并退出 - 按回车确认
4.4 使环境变量生效
# 重新加载配置文件source /etc/profile # 或者重新登录SSH会话exit# 然后重新登录5. 验证安装
5.1 检查Java版本
java -version 预期输出：
java version "17.0.16" 2025-07-15 LTS Java(TM) SE Runtime Environment (build 17.0.16+12-LTS-247) Java HotSpot(TM) 64-Bit Server VM (build 17.0.16+12-LTS-247, mixed mode, sharing) 5.2 检查Java编译器版本
javac -version 预期输出：
javac 17.0.16 5.3 检查JAVA_HOME环境变量
echo$JAVA_HOME预期输出：
/opt/java/jdk-17.0.16 5.4 检查Java路径
which java 预期输出：
/opt/java/jdk-17.0.16/bin/java 5.5 编译测试（可选）
# 创建测试文件cat> Test.java <<'EOF' public class Test { public static void main(String[] args) { System.out.println("JDK 17安装成功！"); } } EOF# 编译 javac Test.java # 运行 java Test 预期输出：
JDK 17安装成功！ 6. 常见问题排查
问题1：java: command not found
错误信息：
bash: java: command not found 可能原因：
- 环境变量未正确配置
- 配置文件未重新加载
解决方案：
# 1. 检查JAVA_HOME是否设置echo$JAVA_HOME# 2. 如果为空，检查配置文件sudocat /etc/profile |grep JAVA_HOME # 3. 重新加载配置source /etc/profile # 4. 或者重新登录SSH问题2：JAVA_HOME路径错误
错误信息：
Error: JAVA_HOME is not set correctly 解决方案：
# 1. 查看实际的JDK目录ls -la /opt/java/ # 2. 确认JDK目录名# 3. 修改 /etc/profile 中的JAVA_HOME路径sudovi /etc/profile # 4. 修改后重新加载source /etc/profile 问题3：权限不足
错误信息：
Permission denied 解决方案：
# 修改目录权限sudochown -R ubuntu:ubuntu /opt/java sudochmod -R 755 /opt/java 问题4：版本显示不正确
可能原因：系统有多个Java版本
解决方案：
# 1. 检查所有Java版本 update-alternatives --list java # 2. 如果安装了多个版本，设置默认版本sudo update-alternatives --config java # 3. 或者直接使用完整路径 /opt/java/jdk-17.0.16/bin/java -version 7. 环境变量配置说明
JAVA_HOME
JDK的安装根目录，其他程序通过这个变量查找Java。
JRE_HOME
Java运行环境的目录（JDK包含JRE）。
CLASSPATH
Java类路径，告诉JVM在哪里查找类文件。
PATH
将Java的bin目录添加到系统路径，使java和javac命令可以在任何地方使用。
8. 完整安装命令序列
如果安装包已上传，可以一次性执行：
# 1. 进入安装目录cd /opt/java # 2. 查看文件ls -la # 3. 解压（根据实际文件名调整）tar -xzf jdk-17.0.16_linux-x64_bin.tar.gz # 4. 查看解压后的目录名ls -la # 5. 编辑配置文件sudovi /etc/profile # 6. 在文件末尾添加（根据实际目录名调整）：# export JAVA_HOME=/opt/java/jdk-17.0.16# export JRE_HOME=$JAVA_HOME/jre# export CLASSPATH=.:$JAVA_HOME/lib:$JRE_HOME/lib# export PATH=$JAVA_HOME/bin:$PATH# 7. 使配置生效source /etc/profile # 8. 验证安装 java -version javac -version echo$JAVA_HOME9. 替代方案：使用apt安装OpenJDK 17
如果不想手动安装，可以使用apt直接安装：
# 更新软件包列表sudoapt update # 安装OpenJDK 17sudoaptinstall -y openjdk-17-jdk # 验证安装 java -version javac -version 优点：
- 安装简单，一条命令搞定
- 自动配置环境变量
- 自动更新
缺点：
- 版本可能不是最新的
- 无法自定义安装位置
10. 总结
本文详细介绍了在Ubuntu 20.04云服务器上安装JDK 17的完整流程：
- ✅ 创建安装目录并设置权限
- ✅ 上传JDK安装包
- ✅ 解压安装包
- ✅ 配置环境变量（JAVA_HOME、PATH等）
- ✅ 验证安装
关键配置点：
JAVA_HOME=/opt/java/jdk-17.0.16：JDK安装路径PATH=$JAVA_HOME/bin:$PATH：将Java命令添加到系统路径source /etc/profile：使配置生效
验证成功标志：
java -version显示版本为17javac -version显示版本为17echo $JAVA_HOME显示正确的路径
📝 参考命令速查
# 查看Java版本 java -version # 查看Java编译器版本 javac -version # 查看JAVA_HOMEecho$JAVA_HOME# 查看Java路径which java # 重新加载环境变量source /etc/profile 🔗 相关文章推荐
💬 问题反馈
如果在安装过程中遇到问题，欢迎在评论区留言，我会及时回复！
如果这篇文章对你有帮助，请点赞👍、收藏⭐、转发📤，让更多人受益！
