客户托管的实例上可以选择配置多个 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）。 |
--cdn-hosts=<s> |
CDN 池的主机名（以英文逗号分隔，默认值：static-a.lookercdn.com,static-b.lookercdn.com）。 |
--cipher-key-file=<s> |
包含加密密钥（仅限旧版加密）的文件的路径。 |
--cloud-trace-enabled |
使用默认凭据或 json 凭据（如果通过 cloud_trace_json_file 提供）启用跟踪（默认：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 |
在环回接口上公开 Core 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 |
在执行密钥更新操作时启用永久性 Blob 存储区重新加密（默认值：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 主机名，以便使用 public_host_url（而非 Looker 中的默认主机网址）构建 Looker Action API 回调 URI。启动选项的输入应为 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 |
允许以 root 身份运行。 Looker 不需要 root 权限即可正常操作。出于安全考虑，我们建议您在非 root 账号中运行 Looker。仅在需要时才使用以 root 身份运行的选项，例如，当 Looker 分析师出于问题排查目的而要求时。 |
--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 |
为搜索服务启用 A/B 测试（默认值：false）。 |
--self-signup |
允许任何人为自己创建账号。 |
--shared-storage-dir=<s> |
网络文件系统共享存储空间的路径。 |
--snowplow-host=<s> |
额外的雪铲收集器。 |
--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> |
提供可从运行 Looker 的服务器访问的外部 SSL 提供商的 host:port。如果未指定，Looker 应用服务器会提供 SSL。以下是 Looker 集群前面的 SSL 代理示例：--ssl-provided-externally-by=192.168.123.13:443下面是一个 SSL 提供程序与 Looker 实例位于同一主机上的示例：--ssl-provided-externally-by=localhost:443null 值表示 Looker 应用服务器提供 SSL。如果您的 Looker 实例在对公共互联网访问受限的服务器上运行，您需要在内部网络上指定一个 IP 地址，该 IP 地址可供 Looker 实例所在的服务器访问。 |
--ssl-provided-externally |
已弃用。请改用 --ssl-provided-externally-by。 |
--staging |
将服务器作为预演运行。此选项会阻止您的预演实例发送定期生成的报告。不过，预演版实例仍会继续运行定时任务，如果定时任务出现任何问题，系统会向定时方案所有者发送错误电子邮件。 |
--staging-override-email=<s> |
将预演版实例上的电子邮件发送到此地址，而不是发送到常规目的地。 |
--stereo-data-search-enabled |
启用立体声数据搜索功能（默认值：false）。 |
--task-monitor-abandoned-query-in-seconds=<i> |
自上次访问任务以来经过的时长（视为放弃查询任务）。 |
--task-monitor-query-startup-interval-in-seconds=<i> |
时长，从查询开始执行到第一次长时间轮询发生时，用作宽限期。这有助于在开始轮询之前为调用方提供更多空间。 |
--task-monitor-sleep-interval-in-seconds=<i> |
任务跟踪线程可以检查任务是否被放弃之前的休眠时间间隔。 |
--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 启动选项后，您就可以为合适的 HTTPS 配置 SSL 证书了。