在客户托管的实例上，您可以选择性地配置多项 Looker 启动设置。如果您不需要更改这些选项，可以不使用这些选项来启动 Looker。
启动选项列表
下表按字母顺序列出了当前的启动选项。您还可以通过运行带有 --help 选项的 Looker 启动脚本来显示启动选项列表。
| 选项 | 说明 |
|---|---|
--alerts-scheduler-threads=<i> |
同时安排的提醒数量（默认值为 3）。 |
--ami |
已弃用。请改用 --marketplace=aws。 |
--api-server-max-threads=<i> |
Puma API 服务器的最大线程数。 |
--api-server-min-threads=<i> |
Puma API 服务器的最小线程数。 |
--application-server-max-threads=<i> |
Puma 应用服务器的最大线程数。 |
--application-server-min-threads=<i> |
Puma 应用服务器的最小线程数。 |
--apply-db-migrations |
在启动时应用数据库迁移。仅在您单独应用迁移时停用（默认值：true）。 |
--async-results-cache-time=<i> |
将异步结果缓存多长时间（默认值：300）。 |
--byoid-studio-load-url=<s> |
用于在 iframe 中加载 BYOID Studio 的网址。 |
--cdn-hosts=<s> |
CDN 池的以英文逗号分隔的主机名（默认值：static-a.lookercdn.com,static-b.lookercdn.com）。 |
--cipher-key-file=<s> |
包含加密密钥的文件的路径（仅限旧版加密）。 |
--cloud-trace-enabled |
使用默认凭据或通过 cloud_trace_json_file 提供的 JSON 凭据启用跟踪功能（默认值：false）。 |
--cloud-trace-json-file=<s> |
包含服务账号凭据的 JSON 文件，用于将轨迹数据上传到 Google Cloud Trace。 |
--cloud-trace-project-id=<s> |
用于上传跟踪记录数据的 Google 项目 ID。 |
--cloud-trace-sample-rate=<f> |
对轨迹进行抽样的速率（0-1）（默认值：0.0）。 |
--clustered |
相应服务器是否属于集群（默认值：false）。 |
--concurrent-render-caching-jobs=<i> |
同时渲染缓存进程的数量（默认值：3）。 |
--concurrent-render-jobs=<i> |
同时运行的 PhantomJS 或 Chromium 渲染进程的数量（默认值为 2）。 |
--core-on-loopback |
在环回接口上公开核心 API（默认值：false）。 |
--core-port=<i> |
运行核心的端口（默认值：19999）。 |
--customer-artifact-maxsize=<i> |
客户制品商店的最大大小（以 MB 为单位）。 |
-d, --internal-db-creds=<s> |
包含数据库凭据的 YAML 文件的路径。 |
--daemonize |
作为守护进程运行（默认值：true）。 |
--default-mailer-domain=<s> |
默认发件人网域。 |
--default-mailer-fromemail=<s> |
默认邮件程序发送的电子邮件的来源电子邮件地址（默认值：Looker <noreply@lookermail.com>）。 |
--default-mailer-host=<s> |
默认邮件程序主机名（默认值：smtp.sendgrid.net）。 |
--default-mailer-password=<s> |
默认邮件程序密码（不建议在命令行中指定密码）。 |
--default-mailer-port=<i> |
默认邮件程序端口（默认值：587）。 |
--default-mailer-username=<s> |
默认电子邮件发送者用户名。 |
--disable-db-log |
停用内部数据库查询的日志记录（默认值：false）。 |
--dogstatsd-host-ip=<s> |
Datadog statsd 服务器主机 IP。 |
--dogstatsd-host-port=<i> |
Datadog 服务器主机端口。 |
-e, --help |
显示此启动选项列表。 |
--enable-blobstore-recryption |
在重新生成密钥操作时启用持久 Blobstore 重新加密（默认值：false）。 |
--error-emails-to=<s> |
发送给 <email address> 的错误电子邮件。 |
--experimental-features=<s> |
以英文逗号分隔的允许的实验性功能列表。 |
--experimental-routes=<s> |
以英文逗号分隔的允许的实验性路由列表，这些路由会生成带有 -next 后缀的路由。 |
--extension-load-url=<s> |
用于将扩展程序加载到安全 iframe 中的网址。 |
--external-solr-enabled |
启用外部 Solr（与默认的嵌入式 Solr 相反）（默认值：false）。 |
--fips |
启用 FIPS-140 加密（默认值：false）。 |
--force-cdn |
强制启用 CDN（默认值：false）。 |
--force-cipher-key |
忽略了针对加密密钥设置的安全措施（仅限旧版加密，默认值：false）。 |
--force-enable-pendo |
在自有品牌实例或嵌入式环境中启用 Pendo 指南（默认值：false）。 |
--force-error-emails |
强制 Looker 通过电子邮件报告错误（默认值：false）。 |
--force-gcm-encryption |
已弃用（此选项不再是必需的）。 |
--force-mismatched-internal-db |
允许使用不同步的 Looker 内部数据库（默认值：false）。 |
--force-no-cdn |
强制停用 CDN（默认值：false）。 |
--git-hooks-use-local-path |
使用 git_hooks 目录的本地路径，而不是共享存储空间。 |
--git-performance-logging |
启用 JGit 性能日志记录（默认值：false）。 |
--google-analytics-tracker-id=<s> |
用于向其他 Google Analytics 跟踪器发送网页浏览数据的跟踪 ID。 |
-h, --hosted |
由 Looker 托管。 |
-H, --hostname=<s> |
用于节点到节点通信的主机名。 |
--hosted-action-hub-disabled |
关闭托管操作中心。 |
--in-memory-cache-size=<i> |
内存中缓存的大小（以 MB 为单位）（默认值：200）。 |
--integration-proxy-cert=<s> |
集成代理 PKI 证书文件的路径。 |
--integration-proxy-key=<s> |
集成代理 PKI 密钥文件的路径。 |
--internal-analytics-connection-file=<s> |
用于描述托管 system__activity 模型数据的内部分析连接的 YAML 文件。此选项仅适用于读取副本后端数据库。 |
--internal-analytics-connection-pool-size=<i> |
可运行系统活动模型查询的并发数据库连接数。此选项仅适用于读取副本后端数据库。 |
--internal-analytics-retention-days=<i> |
在内部数据库中保留历史数据的天数。这不会影响任何 ETL 流程。默认值为 90。此选项仅适用于读取副本后端数据库。 |
--k8s-deployment-api-s3bucket-url=<s> |
此 Looker 进程可将 S3 存储桶凭据写入的网址，以便将其持久化为 Kubernetes Secret。 |
--log-format=<s> |
日志格式，可以是 text 或 json（默认值：text）。 |
--log-level=<s> |
日志级别（默认值：info）。 |
--log-to-file |
将日志输出发送到 Looker 日志文件（默认：true）。 |
--lookml-runtime-cache-size=<i> |
LookML 运行时缓存的大小（以 MB 为单位）（默认值：200）。 |
--loose-cipher-key-file |
不要求对加密密钥文件具有 0600 权限（仅限旧版加密，默认值：false）。 |
--marketplace=<s> |
在 Looker Marketplace 实例中运行。 |
--max-async-threads=<i> |
异步查询线程数上限（默认值：200）。 |
--max-configurable-db-connections=<i> |
界面中允许的客户数据库连接数上限。 |
--max-db-connections-records=<i> |
db_connection 表中允许的最大连接记录数（默认值：10000）。 |
--max-pdt-regen-threads=<i> |
PDT 再生器线程数上限。 |
--max-scheduled-plans=<i> |
有效周期性预定方案的数量上限（默认值：unlimited）。 |
--max-scheduler-jitter-in-seconds=<i> |
用于将计划运行随机分散到指定秒数内的标志。 |
--max-unstreamed-limit=<i> |
设置可为所有非流式传输的查询返回的最大行数（默认值：10 万）。 |
--min-pdt-regen-threads=<i> |
PDT Regenerator 的最小线程数。 |
--monitoring-port=<i> |
用于托管监控（Prometheus 等）的端口（默认值：1552）。 |
-n, --node-to-node-port=<i> |
节点到节点通信的端口（默认值：1551）。 |
--new-cipher-key-file=<s> |
包含新加密密钥的文件的路径（仅限旧版加密）。 |
--on-disk-cache-size=<i> |
磁盘缓存的大小（以 MB 为单位）（默认值为 2000）。 |
-p, --port=<i> |
要运行的端口（默认值：9999）。 |
--per-user-query-limit=<i> |
限制每个用户的并发查询数（默认值：15）。 |
--per-user-query-timeout=<i> |
等待连接的每个用户超时时长（默认值：600）。 |
--prefer-ipv4 |
首选 IPv4。 |
--public-embed-auth-param-file=<s> |
用于公共身份验证的身份验证参数文件。 |
--public-host-url=<s> |
如果启用了 public_host_url 许可功能，管理员可以通过此选项指定 public_host_url 主机名，以便 Looker 操作 API 回调 URI 使用 public_host_url 而不是 Looker 中的默认主机网址来构建。启动选项的输入内容应为 https://<my.host.name>，且网址中不得包含尾部斜杠。如果使用此方法，Looker 管理员还必须将通过操作中心共享数据文档页面上列出的静态出站 IP 地址添加到许可名单中。 |
-q, --queue-broker-port=<i> |
队列代理的端口（默认值：61616）。 |
--qm-long-poll-max-sleep-interval-in-seconds=<f> |
在长轮询 API 检查结果是否可用之前的最大休眠间隔（默认值：1）。 |
--qm-long-poll-sleep-interval-in-seconds=<i> |
在长轮询 API 检查结果是否可用之前的初始休眠时间间隔（默认值：0.1）。 |
--qm-long-poll-timeout-in-seconds=<i> |
长轮询 API 在返回到客户端之前，服务器端的最长超时时间（默认值：30）。 |
--query-manager-max-threads=<i> |
查询管理器的最大线程数。 |
--query-manager-min-threads=<i> |
查询管理器的最小线程数。 |
--query-metrics-retention-hours=<i> |
在内部数据库中保留 query_metrics 数据的小时数（默认值：336）。 |
--queue-startup-timeout-in-seconds=<i> |
启动时允许连接到队列的时长（以秒为单位，默认值为 180）。 |
--query-task-cleanup-interval-seconds=<i> |
查询任务表清理作业之间的时间间隔（默认值：600）。 |
--query-task-persistence-duration-minutes=<i> |
查询完成后，在查询任务表中保留相应行的时间（默认值为 360）。 |
-r, --root |
允许以根用户身份运行。 Looker 在正常运行时不需要 root 权限。出于安全考虑，我们建议您在非 root 账号中运行 Looker。仅在需要时（例如，Looker 分析师出于问题排查目的而提出要求时）才使用此选项以 root 身份运行。 |
--redis-cache-config-file=<s> |
包含 Redis 配置的文件。 |
--report-backend-errors, --no-report-backend-errors |
报告来自后端的错误（默认值：false）。 |
--report-frontend-errors, --no-report-frontend-errors |
报告前端的错误（默认值：false）。注意：此启动选项已过时。请改用 client_monitor 功能标志。 |
-S, --ssh-tunnel-sidecar-url=<s> |
用于连接到 SSH 隧道服务器边车的基本网址。 |
--scheduled-job-attempt-limit=<i> |
调度作业尝试次数上限（默认值：10）。 |
--scheduled-job-max-age-days=<i> |
在被删除之前，已安排的作业的最长存在时间（默认值为 60）。 |
--scheduler-query-limit=<i> |
限制并发的已调度查询的数量（默认值为 10）。 |
--scheduler-query-timeout=<i> |
调度程序等待连接的超时时长（默认值：1200）。 |
--scheduler-start-delay=<i> |
延迟任务运行程序启动的秒数（默认值：60）。 |
--scheduler-threads=<i> |
同时执行的计划任务数（默认值：10）。 |
--search-result-comparison |
将搜索服务结果与旧版结果进行比较（默认值：false）。 |
--search-service |
启用搜索服务（默认值：false）。 |
--search-service-ab-test |
为 Search Service 启用 AB 测试（默认值：false）。 |
--self-signup |
允许任何人自行创建账号。 |
--shared-storage-dir=<s> |
网络文件系统共享存储空间的路径。 |
--snowplow-host=<s> |
额外的 Snowplow 收集器。 |
--solr-basic-auth=<s> |
用于调用 Solr 的基本身份验证凭据（默认值：solr:SolrRocks）。 |
--ssl |
使用 SSL（默认值：true）。 |
--ssl-ca-cert=<s> |
已弃用。请改用 --ssl-keystore。 |
--ssl-cert=<s> |
已弃用。请改用 --ssl-keystore。 |
--ssl-key=<s> |
已弃用。请改用 --ssl-keystore。 |
--ssl-keystore-pass-file=<s> |
包含 ssl-keystore 密码的文件的路径。 |
--ssl-keystore-pass=<s> |
ssl-keystore 文件的密码。 |
--ssl-keystore=<s> |
SSL 的密钥库文件路径。 |
--ssl-provided-externally-by=<s> |
提供外部 SSL 提供商的主机：端口，可从运行 Looker 的服务器访问。如果未指定，Looker 应用服务器会提供 SSL。以下是 Looker 集群前面的 SSL 代理的示例：--ssl-provided-externally-by=192.168.123.13:443以下是与 Looker 实例位于同一主机上的 SSL 提供商的示例：--ssl-provided-externally-by=localhost:443null 值表示 Looker 应用服务器提供 SSL。如果您的 Looker 实例在对公共互联网的访问受限的服务器上运行，您将需要在内部网络中指定一个可供 Looker 实例的服务器访问的 IP 地址。 |
--ssl-provided-externally |
已弃用。请改用 --ssl-provided-externally-by。 |
--staging |
以预发布模式运行服务器。此选项可防止您的临时实例发送定期生成的报告。不过，预演实例仍会继续运行预定任务，并且如果预定任务存在任何问题，还会向预定方案所有者发送错误电子邮件。 |
--staging-override-email=<s> |
将测试版实例上的电子邮件发送到此地址，而不是其正常目的地。 |
--stereo-data-search-enabled |
启用立体数据搜索功能（默认值：false）。 |
--studio-load-url=<s> |
用于在 iframe 中加载工作室的网址。 |
--studio-one-platform-endpoint=<s> |
Studio One Platform API 的端点。 |
--task-monitor-abandoned-query-in-seconds=<i> |
自任务上次访问以来经过的时间，用于确定查询任务是否已放弃。 |
--task-monitor-query-startup-interval-in-seconds=<i> |
从查询开始执行到首次发生长轮询之间用作宽限期的时长。这样一来，在开始投票之前，通话者就有更多时间来表达自己的观点。 |
--task-monitor-sleep-interval-in-seconds=<i> |
任务跟踪线程在检查任务是否被放弃之前的休眠间隔。 |
--unification-jwt-service-account=<s> |
统一 JWT 服务账号。 |
--unlimited-scheduler-threads=<i> |
同时执行的无限期预定任务的数量（默认值：3）。 |
--use-custom-jdbc-config |
是否使用自定义 JDBC 驱动程序配置（默认值：false）。 |
--user-db-credentials |
使用受限。连接可以使用用户专用凭据（默认：false）。 |
-v, --version |
输出版本并退出。 |
凭据文件格式
如果您已将应用数据库更改为 MySQL，则需要一个名为 looker-db.yml 的凭据文件，其中包含以下设置：
dialect: mysql
host: YOUR_HOSTNAME
username: YOUR_USERNAME
password: YOUR_PASSWORD
database: YOUR_DBNAME
port: YOUR_PORT
如果您的 MySQL 数据库需要 SSL 连接，则 looker-db.yml 文件还需要包含以下内容：
ssl: true
使启动选项永久生效
使启动配置设置永久生效的首选方法是在 Looker 应用目录中创建一个名为 lookerstart.cfg 的文件。此文件将由 looker.jar 随附的 Looker 启动脚本执行。建议在 lookerstart.cfg 文件中为 JAVAARGS 和 LOOKERARGS 设置环境变量，因为安装新版本的 Looker 启动脚本时，这些变量不会被覆盖。
以下是一个 lookerstart.cfg 示例，该示例会停用 Looker 的 SSL 并将其设置为在端口 8080 上运行：
LOOKERARGS="--no-ssl --port 8080"
更改 lookerstart.cfg 后，需要重启 Looker。
后续步骤
配置 Looker 启动选项后，您就可以配置 SSL 证书以实现正常的 HTTPS 了。