Fuseki 4.2.0服务器启用SSL报未知https参数错误求助

问题根因 #

你当前使用的Fuseki 4.2.0版本的独立服务端原生不支持命令行配置HTTPS，你查阅的是最新版官方文档，HTTPS启动参数是4.3.0及以上版本才新增的功能，所以你添加参数会报未知参数错误，你找到的源码片段是后续版本新增的功能代码，不在4.2.0的发行包里。

解决方案1（推荐，无需改动现有Fuseki配置）：用Nginx做SSL反向代理 #

RHEL 8自带Nginx安装源，操作门槛更低，不会影响现有服务运行：

• 安装Nginx：dnf install nginx -y
• 如果只有jks格式密钥库，可执行以下命令转成Nginx适配的pem格式：

  # 先转成p12格式
  keytool -importkeystore -srckeystore 你的密钥库.jks -destkeystore fuseki.p12 -srcstoretype JKS -deststoretype PKCS12
  # 再从p12提取证书和私钥
  openssl pkcs12 -in fuseki.p12 -nokeys -out fullchain.pem
  openssl pkcs12 -in fuseki.p12 -nocerts -nodes -out privkey.pem
  

• 把证书文件放到/etc/nginx/cert/目录下，设置权限为nginx用户可读：chown nginx:nginx /etc/nginx/cert/*
• 编辑Nginx配置文件/etc/nginx/conf.d/fuseki.conf，加入如下配置：

  server {
      listen 3043 ssl;
      server_name 你的域名或者服务器IP;
  
      ssl_certificate /etc/nginx/cert/fullchain.pem;
      ssl_certificate_key /etc/nginx/cert/privkey.pem;
      ssl_protocols TLSv1.2 TLSv1.3;
      ssl_ciphers HIGH:!aNULL:!MD5;
  
      location / {
          proxy_pass http://127.0.0.1:3030; # 你现有Fuseki默认监听的端口
          proxy_set_header Host $host;
          proxy_set_header X-Real-IP $remote_addr;
          proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
          proxy_set_header X-Forwarded-Proto $scheme;
      }
  }
  

• 测试Nginx配置是否正确：nginx -t
• 启动Nginx并设置开机自启：systemctl enable --now nginx
• 配置防火墙放通3043端口：firewall-cmd --add-port=3043/tcp --permanent && firewall-cmd --reload
  配置完成后直接访问https://你的IP:3043就能走HTTPS访问Fuseki服务。

解决方案2：升级Fuseki到4.3.0及以上版本 #

如果要使用原生HTTPS参数，可直接升级Fuseki版本，升级不会影响现有数据集数据：

• 停止当前运行的Fuseki服务：systemctl stop fuseki.service
• 备份你现有的数据目录和配置文件
• 下载4.3.0以上版本的Fuseki压缩包，解压到原有目录替换文件
• 修改systemd启动配置，添加对应参数：

  ExecStart=/home/fuseki/apache-jena-fuseki-xxx/fuseki-server -v -tdb2 -update -config=/home/fuseki/fuseki_data/config.ttl --https=/home/fuseki/cert_details.json --httpsPort=3043

• 确保你的cert_details.json格式符合要求，示例如下：

  {
    "keystore": "你的keystore.jks文件绝对路径",
    "passwd": "你的密钥库密码"
  }
  

• 重新加载systemd配置：systemctl daemon-reload
• 启动Fuseki服务即可。

内容的提问来源于stack exchange，提问作者Mitch S.