openrefine在linux上安装本质是解压+启动java进程，无需系统级安装；关键步骤为：确认64位jdk 11+已安装、解压后执行chmod +x refine、启动时用./refine -v排查端口或内存问题。
Linux 上安装 OpenRefine 本质是解压 + 启动 Java 进程，不涉及系统级安装或包管理器注册。只要 JDK 11+ 已就位，5 分钟内就能跑起来——但卡在 refine 脚本没权限、端口被占、内存不足这三处的人最多。
确认 JDK 版本并确保是 64 位
OpenRefine 必须运行在 64 位 JDK 11 或更高版本上。32 位 JDK 或 Java 8 会直接启动失败，报错类似 UnsupportedClassVersionError 或静默退出。
- 运行
java -version，输出中必须含64-Bit字样，且版本号 ≥ 11 - 若用的是 Ubuntu/Debian，别装
default-jre（常为旧版），推荐用apt install openjdk-17-jre-headless - Arch Linux 用户注意：
jdk-openjdk包默认不含 JRE，需额外装jre-openjdk-headless或改用jdk17-openjdk
下载解压后必须 chmod +x refine
Linux 版 OpenRefine 发布包里的 refine 是 shell 脚本，不是可执行二进制。直接 ./refine 会提示 Permission denied。
linux-performance-analyzer
下载
Linux 性能分析与调优专家，覆盖 CPU、内存、磁盘 I/O、网络、内核参数、编译优化、容器/K8s。适用场景：系统卡顿/高负载、内存不足/OOM/Swap 高、CPU 异常/iowait 高。
- 下载官方 tar.gz 包（如
openrefine-linux-3.7.2.tar.gz）后，用tar -xzf解压 - 进入解压目录，运行
chmod +x refine——这步漏掉，后续所有尝试都白搭 - 启动时建议加
-v参数看日志：./refine -v，能快速判断是 Java 找不到，还是端口冲突
启动失败常见原因和对应检查点
浏览器打不开 http://127.0.0.1:3333？先别重装，按顺序查这三项：
-
netstat -tuln | grep :3333—— 端口被占用？改端口：启动时加-p 3334 -
ps aux | grep refine—— 进程是否已后台运行？有时脚本启动后终端关闭，进程还在但你没注意 - 查看
refine.ini中REFINE_MEMORY是否设得过大（比如 8G），而物理内存不足 —— 尤其在 2GB VPS 上，设成2048M反而更稳
首次启动后浏览器打不开的临时对策
OpenRefine 默认绑定 127.0.0.1，某些 Linux 桌面环境（如 GNOME Wayland + Firefox Snap）会因沙盒限制无法自动跳转。这不是 bug，是安全策略。
- 启动后终端会输出类似
Starting OpenRefine on http://127.0.0.1:3333/的提示，复制该 URL 手动粘贴到 Chrome 或 Firefox 地址栏即可 - 不要用
curl http://localhost:3333测试——它返回 302 重定向，不代表服务没起来 - 如果真要远程访问（不推荐用于生产），需修改
refine.ini中的REFINE_HOST为0.0.0.0，并确认防火墙放行对应端口
真正麻烦的不是安装步骤，而是启动后导入 50 万行 CSV 卡住——那基本是内存配置没调对，或者用了带 BOM 的 UTF-8 文件触发解析异常。这两点比安装本身更常耽误事。
