服务器命令行参数

要启动 Appium 服务器，您可以运行 appium 或 appium server。server 子命令被认为是默认的，因此如果您省略它，Appium 将解释为您的请求以运行 Appium 服务器。

appium（或 appium server）的调用可以接受许多参数，这些参数将在下面详细介绍。

注意

如果您愿意，所有这些参数都可以通过 配置文件 设置。在命令行上设置的任何参数将覆盖配置文件中找到的任何参数。

参数	描述	类型	默认值	别名
--address	要监听的 IP 地址	字符串	0.0.0.0	-a
--allow-cors	Appium 服务器是否应允许来自任何主机的 Web 浏览器连接	布尔值	false
--allow-insecure	设置允许在此服务器的会话中运行哪些不安全的特性。特性是在驱动程序级别定义的；有关更多详细信息，请参阅文档。请注意，通过 --deny-insecure 定义的特性将被禁用，即使它们也列在此处。如果为字符串，则为包含策略的文本文件的路径或逗号分隔的列表。	数组	[]
--base-path	用作服务器上运行的所有 Web 驱动程序路由的前缀的基路径	字符串	""	-pa
--callback-address	回调 IP 地址（默认：与 --address 相同）	字符串		-ca
--callback-port	回调端口（默认：与 --port 相同）（值必须介于 1 和 65535 之间）	整数	4723	-cp
--debug-log-spacing	在日志中添加夸张的间距以帮助进行视觉检查	布尔值	false
--default-capabilities	设置默认的所需功能，这些功能将在每个会话上设置，除非被接收到的功能覆盖。如果为字符串，则为包含功能的 JSON 文件的路径，或原始 JSON。	对象		-dc
--deny-insecure	设置在此服务器的会话中不允许运行哪些不安全的特性。特性是在驱动程序级别定义的；有关更多详细信息，请参阅文档。此处列出的特性将不会启用，即使它们也列在 --allow-insecure 中，即使启用了 --relaxed-security。如果为字符串，则为包含策略的文本文件的路径或逗号分隔的列表。	数组	[]
--driver	特定于驱动程序的配置。键应对应于驱动程序包名称	对象
--keep-alive-timeout	Appium 服务器应应用于所有请求的保持活动超时和连接超时的秒数。将其设置为 0 将禁用超时。	整数	600	-ka
--local-timezone	对时间戳使用本地时区	布尔值	false
--log	还将日志输出发送到此文件	字符串		-g
--log-filters	一个或多个日志过滤规则	数组
--log-level	日志级别（console[:file]）（值必须是以下之一：info、info:debug、info:info、info:warn、info:error、warn、warn:debug、warn:info、warn:warn、warn:error、error、error:debug、error:info、error:warn、error:error、debug、debug:debug、debug:info、debug:warn、debug:error）	字符串	debug
--log-no-colors	在控制台输出中不使用颜色	布尔值	false
--log-timestamp	在控制台输出中显示时间戳	布尔值	false
--plugins-import-chunk-size	服务器启动时可以并行导入的插件的最大数量	数字	7
--drivers-import-chunk-size	服务器启动时可以并行导入的驱动程序的最大数量	数字	3
--long-stacktrace	向日志条目添加长堆栈跟踪。建议仅用于调试。	布尔值	false
--no-perms-check	如果设置为 true，则跳过服务器启动时的各种权限检查	布尔值	false
--nodeconfig	将 Appium 注册为 Selenium Grid 3 中的节点的配置 JSON 文件的路径；否则为配置本身	对象
--plugin	特定于插件的配置。键应对应于插件包名称	对象
--port	要监听的端口（值必须介于 1 和 65535 之间）	整数	4723	-p
--relaxed-security	禁用额外的安全检查，因此可以利用驱动程序支持的此选项提供的一些高级功能。仅当所有客户端都在受信任的网络中时才启用它，如果客户端可能潜在地从会话沙箱中逃脱，则情况并非如此。可以使用 --deny-insecure 覆盖特定功能	布尔值	false
--session-override	启用会话覆盖（覆盖）	布尔值	false
--ssl-cert-path	如果使用 TLS，则为 .cert 文件的绝对路径。必须与 --ssl-key-path 一起提供。有关详细信息，请参阅 SSL/TLS/SPDY 支持指南	字符串
--ssl-key-path	如果使用 TLS，则为 .key 文件的绝对路径。必须与 --ssl-cert-path 一起提供。有关详细信息，请参阅 SSL/TLS/SPDY 支持指南	字符串
--strict-caps	如果发送了 Appium 不识别为对所选设备有效的所需功能，则会导致会话失败	布尔值	false
--tmp	Appium 可以用来管理临时文件的目录的绝对路径	字符串	Windows：C:\Windows\Temp 其他：/tmp
--trace-dir	Appium 可以用来保存 iOS 仪器跟踪的目录的绝对路径	字符串	<tmp>/appium-instruments
--use-drivers	要激活的驱动程序列表。默认情况下，将激活所有已安装的驱动程序。	数组	[]
--use-plugins	要激活的插件列表。要激活所有插件，该值应为包含单个项目 "all" 的数组。	数组	[]
--webhook	还将日志输出发送到此 http 侦听器	字符串		-G