atomgraph/linkeddatahub

环境要求

• bash shell 4.x（Linux默认包含；Windows可安装Windows Subsystem for Linux）
• Java的https://docs.oracle.com/en/java/javase/11/tools/keytool.html%EF%BC%88%E9%9C%80%E5%9C%A8%60$PATH%60%E4%B8%AD%EF%BC%8CJDK%E8%87%AA%E5%B8%A6%EF%BC%89
• https://www.openssl.org/%EF%BC%88%E9%9C%80%E5%9C%A8%60$PATH%60%E4%B8%AD%EF%BC%89
• https://man7.org/linux/man-pages/man1/uuidgen.1.html%EF%BC%88%E9%9C%80%E5%9C%A8%60$PATH%60%E4%B8%AD%EF%BC%89
• https://docs.docker.com/install/%EF%BC%88%E5%BB%BA%E8%AE%AEDocker%E5%88%86%E9%85%8D%E8%87%B3%E5%B0%918GB%E5%86%85%E5%AD%98%EF%BC%89
• https://docs.docker.com/compose/install/

安装步骤

1. https://guides.github.com/activities/forking/ 此仓库并克隆到本地文件夹
2. 在文件夹中创建.env文件，填写必要值（可使用https://github.com/AtomGraph/LinkedDataHub/blob/master/.env_sample%E4%BD%9C%E4%B8%BA%E6%A8%A1%E6%9D%BF%EF%BC%89%E3%80%82%E7%A4%BA%E4%BE%8B%EF%BC%9A

   COMPOSE_CONVERT_WINDOWS_PATHS=1
   COMPOSE_PROJECT_NAME=linkeddatahub
   
   PROTOCOL=https
   HTTP_PORT=81
   HTTPS_PORT=4443
   HOST=localhost
   ABS_PATH=/
   
   OWNER_MBOX=john@doe.com
   OWNER_GIVEN_NAME=John
   OWNER_FAMILY_NAME=Doe
   OWNER_ORG_UNIT=My unit
   OWNER_ORGANIZATION=My org
   OWNER_LOCALITY=Copenhagen
   OWNER_STATE_OR_PROVINCE=Denmark
   OWNER_COUNTRY_NAME=DK
   

3. 通过命令行生成SSL证书/密钥（将$owner_cert_pwd和$secretary_cert_pwd替换为自定义密码）：

   ./scripts/setup.sh .env ssl $owner_cert_pwd $secretary_cert_pwd 3650
   

   脚本将创建ssl子文件夹，存放SSL证书和/或公钥。
4. 通过命令行启动应用服务：

   docker-compose up --build
   

   该命令将构建LinkedDataHub的Docker镜像，启动容器并挂载以下子文件夹：
   • data：三元组存储持久化RDF数据
   • uploads：LDH存储内容哈希文件上传 首次启动约需半分钟（数据集加载到三元组存储）。启动成功后，Docker日志最后一行类似：

   linkeddatahub_1     | 09-Feb-2021 14:18:10.536 INFO [main] org.apache.catalina.startup.Catalina.start Server startup in [32609] milliseconds
   

5. 将ssl/owner/keystore.p12导入浏览器（密码为setup.sh中提供的$owner_cert_pwd）：
   • Google Chrome：设置 > 高级 > 管理证书 > 导入...
   • Mozilla Firefox：选项 > 隐私与安全 > 查看证书... > 导入...
   • Apple Safari：直接安装到系统，通过https://support.apple.com/guide/key***access/what-is-key***access-kyca1083/mac%E5%B7%A5%E5%85%B7%E5%AF%BC%E5%85%A5%EF%BC%88%E6%8B%96%E8%87%B3%60local%60%E5%8C%BA%E5%9F%9F%EF%BC%89
   • Microsoft Edge：不支持证书管理，需安装到Windows，详见
6. 在浏览器中打开 https://localhost:4443/

注意事项

• 由于nginx依赖LinkedDataHub健康检查（每20秒一次），Web服务器可能需要最多一分钟才可用
• 由于自签名服务器证书，浏览器可能显示警告（如Chrome的“您的连接不是私密连接”或Firefox的“潜在安全风险 ahead”），忽略警告：点击“高级”并“继续”或“接受风险”
  • 若Chrome中无此选项（部分macOS设备），可打开chrome://flags/#allow-insecure-localhost，将“允许来自localhost的无效证书”设为“启用”并重启Chrome
• 在macOS Finder中，.env_sample和.env可能隐藏（以点开头的文件），可通过https://stackoverflow.com/questions/5891365/mac-os-x-doesnt-allow-to-name-files-starting-with-a-dot-how-do-i-name-the-hta
• Linux系统中，用户可能需加入docker组：

sudo usermod -aG docker ${USER}

重新登录用户。不推荐的替代方法：

sudo docker-compose up

基础URI

常见场景是将默认基础URI https://localhost:4443/ 更改为自定义URI。

以 https://ec2-54-235-229-141.compute-1.amazonaws.com/linkeddatahub/ 为例，需将URI拆分为组件并在.env文件中设置：

PROTOCOL=https
HTTP_PORT=80
HTTPS_PORT=443
HOST=ec2-54-235-229-141.compute-1.amazonaws.com
ABS_PATH=/linkeddatahub/

ABS_PATH为必填项，即使仅为/。

数据空间

数据空间在 https://github.com/AtomGraph/LinkedDataHub/blob/master/config/system-varnish.trig 中配置。相对URI将基于.env中配置的基础URI解析。

:warning: 不要使用空白节点标识应用或服务。建议使用urn: URI方案，因为LinkedDataHub应用资源无法通过自身数据空间访问。

环境变量

LinkedDataHub支持通过docker-compose.yml中的环境参数配置多项选项，常见选项如下：

CATALINA_OPTS

Tomcat的https://tomcat.apache.org/tomcat-9.0-doc/RUNNING.txt

SELF_SIGNED_CERT

服务器证书是否为自签名（true表示是）

SIGN_UP_CERT_VALIDITY

注册用户WebID证书的有效期（非所有者证书）

IMPORT_KEEPALIVE

数据导入HTTP连接超时时间（毫秒），导入大文件时需设置更长时间以确保完成

MAX_CONTENT_LENGTH

请求体的最大允许大小（字节）

MAIL_SMTP_HOST

邮件服务器主机名

MAIL_SMTP_PORT

邮件服务器端口号

GOOGLE_CLIENT_ID

Google OAuth 2.0客户端ID，提供后启用“使用Google登录”认证方式

GOOGLE_CLIENT_SECRET

Google客户端密钥

更多选项详见https://atomgraph.github.io/LinkedDataHub/linkeddatahub/docs/reference/configuration/%E3%80%82

重置

如需重置设置（如配置新基础URI后），可执行：

sudo rm -rf data uploads && docker-compose down -v

:warning: 此操作将删除持久化数据、文件及Docker卷。