BlockScout 环境变量详解

变量名	是否必须	描述	默认值	版本	需要重新编译
NETWORK	✅	主 EVM 网络的环境变量，例如 Ethereum 或 POA	POA	all
SUBNETWORK	✅	子网的环境变量，例如 Core 或 Sokol Network。这将在链列表下拉列表中显示为选中状态。	POA Sokol	all
LOGO	✅	标题徽标图像位置的环境变量。可以在此处找到不同链的徽标文件名称	/images/blockscout_logo.svg	all
LOGO_FOOTER	✅	页脚徽标图像位置的环境变量。可以在此处找到不同链的徽标文件名称	/images/blockscout_logo.svg
ETHEREUM_JSONRPC_VARIANT	✅	告诉应用程序节点正在使用哪个 RPC 客户端（即 geth、parity、besu 或 ganache）（有关更多信息，请参阅客户端设置）	parity	all
ETHEREUM_JSONRPC_HTTP_URL	✅	用于获取块、交易、收据、令牌的 RPC 端点。	localhost:8545	all
ETHEREUM_JSONRPC_TRACE_URL		trace_block 和 trace_replayTransaction 使用的 Geth/Parity/Besu 客户端专用的 RPC 端点。这可用于指定跟踪节点。	localhost:8545	all
ETHEREUM_JSONRPC_WS_URL	✅	WebSockets RPC 端点用于订阅 newHeads 订阅，提醒索引器获取新块。	ws://localhost:8546	all
ETHEREUM_JSONRPC_TRANSPORT		指定 Blockscout 连接到以太坊节点的传输。可用的传输是 http 和 ipc。如果选择了 ipc，还要设置 IPC_PATH 变量	http	v3.1.0+
IPC_PATH		如果选择 IPC 传输，则运行节点的 IPC 文件的路径	(empty)	v2.1.1+
NETWORK_PATH		用于设置与根目录中显示的内容不同的网络路径。例如，将 /eth/mainnet/ 添加到根目录。	/	all
API_PATH		API 文档页面的 API 端点 URL 中的 PATH	/	v3.1.0+
SOCKET_ROOT		自定义 websocket 路径	(empty)	v3.0.0+
BLOCKSCOUT_HOST		API 端点示例的主机	localhost	v2.1.0+
BLOCKSCOUT_PROTOCOL		blockscout 的 URL 方案	in prod env https is used, in dev env http is used	v2.1.0+
SECRET_KEY_BASE	✅	使用 mix phx.gen.secret 生成新的 Secret Key Base 字符串以保护生产资产。	(empty)	all
CHECK_ORIGIN		当原始标头存在时，用于检查请求的来源。它默认为假。如果为真，它将检查主机值。	FALSE	all
PORT	✅	应用程序运行的默认端口是 4000	4000	all
COIN	✅	此处的硬币通过 CoinGecko API 检查以获取图形和 UI 其他区域的美元价格	POA	all
COINGECKO_COIN_ID		显式设置 CoinGecko 币 ID	(empty)	v3.1.2+
METADATA_CONTRACT		POA Network 专门使用此环境变量来获取验证器信息以显示在 UI 中。	(empty)	all
VALIDATORS_CONTRACT		POA Network 专门使用此环境变量来获取当前验证者的列表。	(empty)	all
KEYS_MANAGER_CONTRACT		POA Network专门使用这个环境变量来设置KeysManager代理合约，以便通过挖掘密钥获得支付密钥。这需要确定对验证者的分布式奖励。	(empty)	v3.1.2+
REWARDS_CONTRACT		排放奖励合约地址。仅当 EMISSION_FORMAT 设置为 POA 时才使用此环境变量	0xeca443e8e1ab29971a45a9c57a6a9875701698a5	v2.0.4+
TOKEN_BRIDGE_CONTRACT		代币桥代理合约。用于 TokenBridge 供应模块。	0x7301CFA0e1756B71869E93d4e4Dca5c7d0eb0AA6	v1.3.2+
EMISSION_FORMAT		如果您的区块发射与 POA 网络相同，则应设置为 POA。仅当设置了 CHAIN_SPEC_PATH 时才使用此环境变量	DEFAULT	v2.0.4+
CHAIN_SPEC_PATH		用于导入区块排放奖励范围和创世账户余额的链规范路径（绝对文件系统路径或 URL）。支持 Geth 和 OpenEthereum 风格的规范。	(empty)	v2.0.4+
SUPPLY_MODULE		xDai Chain/RSK 使用此环境变量来告诉应用程序如何计算链的总供应量。可用值为 TokenBridge、RSK	(empty)	all
SOURCE_MODULE		该环境变量用于计算汇率，专门供xDai Chain使用。可用值为 TokenBridge	(empty)	all
DATABASE_URL	✅	用于定义数据库端点的变量。	(empty)	all
POOL_SIZE		用于定义允许的数据库连接数的生产环境变量。	20	all
ECTO_USE_SSL		在 Ecto 查询上使用 SSL 的生产环境变量。	TRUE	all
DATADOG_HOST		Datadog 集成的主机配置设置	(empty)	all
DATADOG_PORT		Datadog 集成的端口配置设置。	(empty}	all
SPANDEX_BATCH_SIZE		Spandex 和 Datadog 配置设置。	(empty)	all
SPANDEX_SYNC_THRESHOLD		Spandex 和 Datadog 配置设置。	(empty)	all
HEART_BEAT_TIMEOUT		生产环境变量，用于在发生崩溃时重新启动应用程序。	30	all
HEART_COMMAND		生产环境变量，用于在发生崩溃时重新启动应用程序。	(empty)	all
BLOCKSCOUT_VERSION		添加到页脚以表示当前的 BlockScout 版本。	(empty)	v1.3.4+
RELEASE_LINK		页脚中指向 Blockscout 发行说明的链接。	https: //github.com/poanetwork/ blockscout/releases/ tag/${BLOCKSCOUT_VERSION}	v1.3.5+
ELIXIR_VERSION		在 Blockscout 部署之前要在节点上安装的 Elixir 版本。用于 Terraform / Ansible 部署脚本中的 bash 脚本	(empty)	all
BLOCK_TRANSFORMER		块变压器：基地或集团。	base	v1.3.4+
GRAPHIQL_TRANSACTION		对 GraphiQL 的示例查询中的默认事务哈希。	(empty)	v1.2.0+	✅
FIRST_BLOCK		索引开始的块号。	0	v1.3.8+
LAST_BLOCK		索引停止的块号。	(empty)	v2.0.3+
LINK_TO_OTHER_EXPLORERS		真假。如果为 true，则在页脚中添加指向其他资源管理器的链接	(empty)	v1.3.0+
OTHER_EXPLORERS		替代资源管理器列表。此环境变量是在 PR #3414 中引入的。	(empty)	v3.4.0+
SUPPORTED_CHAINS		显示在页脚和链下拉列表中的支持链数组。这个 var 是在这个 PR #1900 中引入的，看起来像一个 JSON 对象数组。	(empty)	v2.0.0+
BLOCK_COUNT_CACHE_PERIOD		具有共识计数缓存的块的生存时间（以秒为单位）。这个变量是在 #1876 中引入的	2 hours	v2.0.0+
TXS_COUNT_CACHE_PERIOD		重新启动任务的间隔（以秒为单位），它计算总 txs 计数。	2 hours	v1.3.9+
ADDRESS_COUNT_CACHE_PERIOD		缓存的生存时间（以秒为单位）。这个变量是在 #2822 中引入的	2 hours	v2.1.1+
ADDRESS_SUM_CACHE_PERIOD		地址总和（烧录地址除外）缓存的生存时间（以秒为单位）。这个变量是在 #2862 中引入的	1 hour	v2.1.1+
TOTAL_GAS_USAGE_CACHE_PERIOD		以秒为单位重新启动任务的间隔，它计算总气体使用量。	2 hours	v3.4.0+
ADDRESS_TRANSACTIONS_GAS_USAGE_COUNTER_CACHE_PERIOD		以秒为单位重新启动任务的时间间隔，该任务计算地址处的气体使用量。	30 minutes	v3.4.0+
TOKEN_HOLDERS_COUNTER_CACHE_PERIOD		以秒为单位重新启动任务的时间间隔，该任务计算代币的持有者数量。	1 hour	v3.4.0+
TOKEN_TRANSFERS_COUNTER_CACHE_PERIOD		以秒为单位重新启动任务的间隔，它计算令牌的传输计数。	1 hour	v3.4.0+
ADDRESS_WITH_BALANCES_UPDATE_INTERVAL		在间隔以秒为单位重新启动任务，该任务计算带有余额的地址。	30 minutes	v1.3.9+
TOKEN_METADATA_UPDATE_INTERVAL		以秒为单位重新启动更新令牌元数据的任务的时间间隔	60 * 60 * 24 * 2	v2.0.1+
AVERAGE_BLOCK_CACHE_PERIOD		平均块周期缓存的更新，以秒为单位	30 minutes	v2.0.2+
MARKET_HISTORY_CACHE_PERIOD		更新市场历史缓存，以秒为单位	6 hours	v2.0.2+
ALLOWED_EVM_VERSIONS		用于合同验证的允许 EVM 版本的逗号分隔列表。这个变量是在 #1964 中引入的	“homestead, tangerineWhistle, spuriousDragon, byzantium, constantinople, petersburg”	v2.0.0+
UNCLES_IN_AVERAGE_BLOCK_TIME		在平均区块时间计算中包括或排除非共识区块。如果为假则排除。	FALSE	v2.0.1+
DISABLE_WEBAPP		如果为 true，则 webapp 的端点是隐藏的（编译时）。此外，启用它会使通知通过 db_notify	FALSE	v2.0.3+	✅
DISABLE_READ_API		如果为 true，则 API 的只读端点被隐藏（编译时）	FALSE	v2.0.3+	✅
DISABLE_WRITE_API		如果为 true，则向 API 写入端点是隐藏的（编译时）	FALSE	v2.0.3+	✅
DISABLE_INDEXER		如果为 true，则索引器应用程序不会运行	FALSE	v2.0.3+	✅
WEBAPP_URL		链接到 Web 应用程序实例，例如协议：//主机/路径	(empty)	v2.0.3+
API_URL		链接到 API 实例，例如协议：//主机/路径	(empty)	v2.0.3+
WOBSERVER_ENABLED		如果 true 启用 wobserver 接口	(empty)	v3.3.2+	✅
SHOW_ADDRESS_MARKETCAP_PERCENTAGE		在顶部帐户页面上配置市值百分比列	TRUE	v2.1.1+
CHECKSUM_ADDRESS_HASHES		如果设置为 true，则重定向到地址哈希的校验和版本	TRUE	v3.1.0+
CHECKSUM_FUNCTION		定义校验和地址函数。 2 个可用值：rsk、eth	eth	v2.0.1+
DISABLE_EXCHANGE_RATES		禁用或启用从 Coingecko API 获取硬币价格	FALSE	v3.1.2+
DISABLE_KNOWN_TOKENS		禁用或启用已知合约的代币符号	FALSE	v3.4.0+
ENABLE_TXS_STATS		禁用或启用每天的 txs 统计信息收集	FALSE	v3.1.2+
SHOW_PRICE_CHART		在主页上禁用或启用硬币图表的价格和市值	FALSE	v3.1.2+
SHOW_TXS_CHART		在主页上禁用或启用每日交易次数图表	FALSE	v3.1.2+
HISTORY_FETCH_INTERVAL		以分钟为单位的间隔 请求每天的 txs 计数以在主页上显示每天的 txs 计数图表的频率	60	v3.1.2+
TXS_HISTORIAN_INIT_LAG		txs 计数历史获取中的初始延迟（以分钟为单位），以便在主页上显示每天的 txs 计数历史图表	0	v3.1.2+
TXS_STATS_DAYS_TO_COMPILE_AT_INIT		获取每天 txs 计数历史的天数，以便将其显示在主页上的每天 txs 计数历史图表中	365	v3.1.2+
COIN_BALANCE_HISTORY_DAYS		在硬币余额历史图表中考虑的天数	10	v3.1.3+
APPS_MENU		真假。如果为 true，则会出现 Apps 导航菜单项	FALSE	v3.3.1+
EXTERNAL_APPS		在应用程序菜单项中显示的一组外部应用程序。这个 var 是在这个 PR #3184 中引入的，看起来像一个 JSON 对象数组。	(empty)	v3.3.1+
ETH_OMNI_BRIDGE_MEDIATOR		家庭 OmniBridge 调解器的地址，用于桥接来自以太坊的多个令牌。提供此地址可启用桥接代币功能：桥接状态和链接到外部链中的原始代币。	(empty)	v3.6.0+
BSC_OMNI_BRIDGE_MEDIATOR		家庭 OmniBridge 中介的地址，用于桥接币安智能链的多个代币。提供此地址可启用桥接代币功能：桥接状态和链接到外部链中的原始代币。	(empty)	v3.6.0+
AMB_BRIDGE_MEDIATORS		以逗号分隔的 AMB 扩展的中介地址哈希列表，用于通过这些中介获取桥接令牌。	(empty)	v3.3.3+
GAS_PRICE		Gwei 的天然气价格。如果变量存在，gas price 将显示在主页上	(empty)	v3.3.2+
FOREIGN_JSON_RPC		JSON RPC 端点到外链，以便通过 Omni-bridge 令牌获取桥接的元数据。它在此 PR #3282 中介绍	(empty)	v3.3.3+
BRIDGE_MARKET_CAP_UPDATE_INTERVAL		TokenBridge 供应模块的市值更新间隔与 TokenBridge 和 OmniBridge 一样，以秒为单位。它在此 PR #3293 中介绍	30 minutes	v3.3.3+
RESTRICTED_LIST		以逗号分隔的地址列表，以启用对它们的受限访问	(empty)	v3.3.3+
RESTRICTED_LIST_KEY		访问RESTRICTED_LIST 变量中列出的地址的键。可以通过查询参数传递到页面的 URL：?key=…	(empty)	v3.3.3+
ADDRESS_TRANSACTIONS_CACHE_PERIOD		地址的交易计数器的生存时间（以秒为单位）。这个变量是在 #3330 中引入的	1 hour	v3.4.0+
DISABLE_BRIDGE_MARKET_CAP_UPDATER		禁用来自 TokenBridge、OmniBridge 和 AMB 扩展的 TokenBridge 市值的重复合并	(empty)	v3.3.3+
POS_STAKING_CONTRACT		POSDAO 质押合约的地址。提供后，启用 Staking DApp。 ValidatorSet 和 BlockReward 合约地址是使用相应的 getter 获取的。	(empty)	v3.4.0+
ENABLE_POS_STAKING_IN_MENU		在菜单中启用 Staking dapp	FALSE	v3.6.0+
TOKEN_EXCHANGE_RATE_CACHE_PERIOD		管理令牌汇率的缓存失效。	(empty)	v3.5.0+
ADDRESS_TOKENS_USD_SUM_CACHE_PERIOD		管理每个代币持有者地址的代币美元价值总和的缓存失效期	(empty)	v3.5.0+
SHOW_MAINTENANCE_ALERT		在资源管理器顶部禁用/启用公告	FALSE	v3.6.0+
MAINTENANCE_ALERT_MESSAGE		资源管理器顶部公告的消息文本	(empty)	v3.6.0+
SHOW_STAKING_WARNING		在质押 dapp 中禁用/启用公告	FALSE	v3.6.0+
STAKING_WARNING_MESSAGE		Staking dapp内公告的消息文本	(empty)	v3.6.0+
CUSTOM_CONTRACT_ADDRESSES_TEST_TOKEN		测试代币地址列表：将应用测试标签，这些代币将被排除在全桥市值计算之外	(empty)	v3.6.0+
ENABLE_SOURCIFY_INTEGRATION		通过 Sourcify 启用或禁用合同验证	FALSE	v3.7.0+
SOURCIFY_SERVER_URL		Sourcify 后端的 URL	https://sourcify.dev/server	v3.7.0+
SOURCIFY_REPO_URL		具有完全验证合同的 Sourcify 存储库的 URL	https://repo.sourcify.dev/contracts/* *before 3.7.1 https://repo.sourcify.dev/contracts/full_match/	v3.7.0+
CHAIN_ID		网络的链 ID。例如，在 xDai 链的情况下为 100。	(empty)	v3.7.0+
MAX_SIZE_UNLESS_HIDE_ARRAY		在智能合约中隐藏长数组。要获取更多详细信息：#4218	50	master