Chhoto URL配置全解析：从基础设置到高级功能的20个环境变量

Chhoto URL配置全解析从基础设置到高级功能的20个环境变量【免费下载链接】chhoto-urlA simple, blazingly fast, selfhosted URL shortener with no unnecessary features; written in Rust.项目地址: https://gitcode.com/gh_mirrors/ch/chhoto-urlChhoto URL是一款用Rust编写的简单、极速且自托管的URL缩短器没有多余功能。通过环境变量配置你可以轻松定制其行为满足从个人使用到企业部署的各种需求。本文将详细介绍20个核心环境变量帮助你从基础设置到高级功能全面掌握Chhoto URL的配置方法。基础网络配置CHHOTO_LISTEN_ADDRESS指定服务监听地址默认值0.0.0.0控制Chhoto URL服务绑定的网络接口。设置为127.0.0.1可仅允许本地访问生产环境建议保持默认值以接受所有网络接口的连接。CHHOTO_LISTEN_PORT设置服务端口默认值4567指定服务监听的端口号。若需要使用80或443等特权端口需确保服务具有相应权限。修改后请同步更新防火墙规则。数据库配置CHHOTO_DB_URL自定义数据库路径默认路径/data/urls.sqlite指定SQLite数据库文件的存储路径。支持绝对路径和相对路径例如./data/mydb.sqlite。配置后系统会自动创建目录结构。CHHOTO_SQLITE_USE_WAL_MODE启用WAL模式默认值False设置为True启用SQLite的WALWrite-Ahead Logging模式显著提升并发写入性能。推荐生产环境启用此选项export CHHOTO_SQLITE_USE_WAL_MODETrueCHHOTO_SQLITE_ENSURE_ACIDACID合规性控制默认值True控制数据库是否严格遵循ACID特性。设置为False可提高性能但在意外断电时可能导致数据丢失。仅建议在临时环境使用。URL与重定向设置CHHOTO_SITE_URL配置网站基础URL默认值自动生成http://localhost:端口设置网站的公共访问URL用于生成缩短链接。例如export CHHOTO_SITE_URLhttps://short.example.com系统会自动处理带引号的输入并在未配置时根据端口自动选择HTTP/HTTPS协议。CHHOTO_REDIRECT_METHOD设置重定向类型默认值永久重定向301设置为TEMPORARY使用临时重定向302适用于需要统计点击或临时跳转的场景。永久重定向301会被浏览器缓存适合长期稳定的链接。CHHOTO_EXTRA_PROTOCOLS添加允许的URL协议默认支持http、https、ftp、magnet通过逗号分隔的列表添加额外支持的URL协议例如export CHHOTO_EXTRA_PROTOCOLSssh,git系统会自动过滤包含非字母数字字符的协议名称。安全设置CHHOTO_API_KEY设置API访问密钥无默认值配置后启用API访问控制所有API请求需包含有效的API密钥。系统会自动检测密钥强度低于90分将发出警告并提供安全密钥建议。生成安全密钥的方法可参考backend/src/auth.rs中的gen_key()函数实现。CHHOTO_PASSWORD设置管理密码无默认值设置后启用密码保护限制对管理功能的访问。未配置时API将对公众开放生产环境强烈建议设置强密码。CHHOTO_HASH_ALGORITHM选择密码哈希算法默认值None设置为Argon2启用Argon2密码哈希算法提供更强的安全性。需确保编译时包含Argon2支持。高级功能配置CHHOTO_SLUG_LENGTH自定义短码长度默认值8最小值4设置生成的短码长度例如export CHHOTO_SLUG_LENGTH6过短的长度可能导致链接冲突建议保持默认值或根据预期使用量调整。CHHOTO_SLUG_STYLE选择短码生成风格默认值Pair形容词-名词组合设置为UID使用纯数字UID风格短码。Pair风格生成更易记的短码如happy-sunsetUID风格生成纯数字短码如12345678。CHHOTO_TRY_LONGER_SLUG冲突时自动增长长度默认值False设置为True时当短码冲突时自动尝试增加长度生成新短码。仅对UID风格短码有效。CHHOTO_ALLOW_CAPITAL_LETTERS允许大写字母默认值False设置为True允许短码包含大写字母增加可用字符集从而减少短码长度。注意URL通常区分大小写但部分系统可能不严格遵循此规范。前端与界面设置CHHOTO_DISABLE_FRONTEND禁用前端界面默认值False设置为True将禁用Web前端界面仅保留API功能。适合作为纯后端服务使用。CHHOTO_CACHE_CONTROL_HEADER自定义缓存头无默认值设置HTTP响应的Cache-Control头控制浏览器缓存行为。例如export CHHOTO_CACHE_CONTROL_HEADERpublic, max-age3600CHHOTO_CUSTOM_LANDING_DIRECTORY自定义着陆页目录无默认值指定自定义着陆页的目录路径用于替换默认首页。配置后管理界面将移至/admin/manage/路径。CHHOTO_FRONTEND_PAGE_SIZE设置分页大小默认值10控制管理界面中链接列表的分页大小例如export CHHOTO_FRONTEND_PAGE_SIZE20公共访问控制CHHOTO_PUBLIC_MODE启用公共模式默认值Disable设置为Enable允许匿名用户创建短链接。建议配合过期时间使用以防止滥用。CHHOTO_PUBLIC_MODE_EXPIRY_DELAY公共链接过期时间无默认值单位秒在公共模式下设置链接的自动过期时间例如export CHHOTO_PUBLIC_MODE_EXPIRY_DELAY86400 # 24小时仅在公共模式启用时生效。配置示例以下是一个完整的生产环境配置示例# 基础网络配置 export CHHOTO_LISTEN_ADDRESS0.0.0.0 export CHHOTO_LISTEN_PORT8080 # 数据库配置 export CHHOTO_DB_URL/data/chhoto/urls.sqlite export CHHOTO_SQLITE_USE_WAL_MODETrue # URL设置 export CHHOTO_SITE_URLhttps://short.example.com export CHHOTO_REDIRECT_METHODPERMANENT # 安全设置 export CHHOTO_API_KEYyour_secure_api_key_here export CHHOTO_PASSWORDstrong_admin_password export CHHOTO_HASH_ALGORITHMArgon2 # 高级功能 export CHHOTO_SLUG_LENGTH6 export CHHOTO_SLUG_STYLEPair export CHHOTO_ALLOW_CAPITAL_LETTERSFalse # 公共访问控制 export CHHOTO_PUBLIC_MODEEnable export CHHOTO_PUBLIC_MODE_EXPIRY_DELAY604800 # 7天通过合理配置这些环境变量你可以将Chhoto URL从简单的URL缩短器转变为功能完善的链接管理系统。所有配置项均在backend/src/config.rs中定义和处理如需深入了解实现细节可查看该文件的源代码。【免费下载链接】chhoto-urlA simple, blazingly fast, selfhosted URL shortener with no unnecessary features; written in Rust.项目地址: https://gitcode.com/gh_mirrors/ch/chhoto-url创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考