opensearch是elasticsearch 7.10.2的开源分支，由aws主导发起，完全兼容其rest api和dsl语法，但移除了sspl许可证限制，是可生产级替代方案；它禁止root启动，需专用用户、调优系统参数（如nofile、vm.max_map_count）、正确配置network.host与discovery.type，并处理默认启用的安全插件。
OpenSearch 是 Elasticsearch 7.10.2 的一个开源分支，由 AWS 主导发起，完全兼容其 REST API 和 DSL 语法，但去除了 Elastic 商业许可证（SSPL）限制。它不是“轻量版 ES”，而是可生产级替代方案——尤其适合不想被许可绑架、又不愿重写搜索逻辑的团队。
为什么不能直接用 root 启动 OpenSearch
OpenSearch 明确禁止以 root 用户启动服务，这是硬性安全策略，不是建议。一旦用 root 运行，进程会立即退出并打印错误：java.lang.RuntimeException: can not run opensearch as root。
- 必须创建专用用户（如
opensearch），并用chown -R opensearch:opensearch /path/to/opensearch递归赋权 -
config/opensearch.yml中的path.data和path.logs目录也必须归属该用户，否则启动时提示access denied - 若已用 root 解压过安装包，仅改配置文件没用，必须重设目录所有权
关键系统参数不调，服务根本起不来
OpenSearch 对 Linux 内核参数比 ES 更敏感，常见两个报错直接卡死启动：
Zynq‑7000 / Zynq UltraScale+ 硬件调试技能。适用于 Xilinx Zynq（Cortex‑A9/A53 + FPGA）Linux 环境，调试 I2C、I2S、UART、GPIO 等外设。包括设备树配置、内核驱动、用户空间调试工具、交叉编译和常见问题排查，支持 PetaLinux 开发。
-
max file descriptors [4096] for opensearch process is too low：需在/etc/security/limits.conf中为opensearch用户单独设限，不能只写*，例如：opensearch soft nofile 65536opensearch hard nofile 65536 -
max virtual memory areas vm.max_map_count [65530] is too low：必须用 root 执行sysctl -w vm.max_map_count=262144，且写入/etc/sysctl.conf持久化，否则重启后失效 - 注意：修改 limits 后需切换到 opensearch 用户执行
ulimit -n验证是否生效，不是看 root 下的值
外网访问失败？重点检查三个配置项
默认只监听 localhost，即使开了防火墙端口（9200）也连不上。要开放外网访问，必须同时满足：
-
config/opensearch.yml中设置：network.host: 0.0.0.0（或具体内网 IP）http.port: 9200discovery.type: single-node（单机必设，否则报 cluster discovery 错误） - 确保
plugins/opensearch-security/目录存在且未被误删（OpenSearch 默认启用安全插件）；若不需要认证，可临时禁用：plugins.security.disabled: true（加在opensearch.yml底部） - 云服务器（如阿里云、腾讯云）必须在控制台安全组里放行
9200端口，光开本地防火墙（firewalld/ufw）不够
启动后 curl 返回 401？别急着关安全插件
OpenSearch 7.10.2+ 默认启用 opensearch-security 插件，首次启动会自动生成 TLS 证书和 admin 密码，日志里有明确提示：Admin password is: xxxxxxxx。
- 用
curl -u 'admin:<password>' https://localhost:9200/_cat/indices?v</password>才能成功访问（注意是 HTTPS，默认启用了 TLS） - 若坚持用 HTTP，必须在
opensearch.yml中显式关闭：plugins.security.ssl.http.enabled: falseplugins.security.allow_default_init_securityindex: true - 切勿直接删掉
plugins/opensearch-security目录——会导致节点无法加入集群、索引创建失败等隐性问题
OpenSearch 的“平滑替代”是有条件的：API 兼容不等于配置零迁移。最常被忽略的是安全插件的默认开启行为，以及单节点模式下 discovery.type 的强制要求——这两处不手动干预，连健康检查都通不过。
