环境变量
在 laf「开发控制台」,点击左下角的「设置」按钮,可打开「应用设置」面板,在「环境变量」可修改/添加环境变量。
访问环境变量
可通过 process.env
访问应用环境变量。
export default async function (ctx: FunctionContext) {
const appid = process.env.APPID
console.log(appid)
}
2
3
4
内置的环境变量
提示
通常不需要手动修改应用的内置环境变量,可能会对应用产生不可预期的影响,除非你很清楚其用法用途。
APPID
process.env.APPID
可获取当前应用的 appid
,请勿修改此项。
NPM_INSTALL_FLAGS
process.env.NPM_INSTALL_FLAGS
可用于配置应用安装依赖时的额外参数,默认为空。
如果你需要指定应用执行 npm install
指令的镜像源,可添加此环境变量覆盖默认配置,如:
NPM_INSTALL_FLAGS="--registry=https://registry.npmjs.org"
TIP
在 laf.run 公有云上,为了加速中国大陆地区的应用初始化速度,使用了加速镜像,该值默认为 --registry=https://registry.npmmirror.com --canvas_binary_host_mirror=https://npmmirror.com/mirrors/canvas --sharp_binary_host=https://npmmirror.com/mirrors/sharp --sharp_libvips_binary_host=https://npm.taobao.org/mirrors/sharp-libvips
SERVER_SECRET
process.env.SERVER_SECRET
是应用运行时默认的服务端密钥,默认用于内置的 JWT 令牌的生成和验签,通常不需要修改此项。
⚠️ 此项环境变量不可为空,不可被删除。
相关内容 云函数认证。
DB_URI
process.env.DB_URI
用于获取云数据库的连接地址,请勿修改此项。
LOG_LEVEL
process.env.LOG_LEVEL
用于控制日志输出的级别,默认值为 debug
,可选值有:
debug
输出所有日志。info
输出除console.debug()
以外的所有日志。warn
仅输出console.warn()
和console.error()
的日志。error
仅输出console.error()
日志。
LOG_DEPTH
process.env.LOG_DEPTH
用于控制打印 Javascript 对象的嵌套深度,默认值为 1
,最大可用值为 5
。
REQUEST_LIMIT_SIZE
process.env.REQUEST_LIMIT_SIZE
用于配置 HTTP 请求体大小的上限,默认值为 10mb
,开发者可根据业务需要调整此值。
OSS_EXTERNAL_ENDPOINT
process.env.OSS_EXTERNAL_ENDPOINT
用于获取云存储的外网访问入口地址,在公有云中其值为 https://oss.laf.run
,请勿修改此项。
OSS_INTERNAL_ENDPOINT
process.env.OSS_INTERNAL_ENDPOINT
用于获取云存储的内网访问入口地址,请勿修改此项。
OSS_REGION
process.env.OSS_REGION
用于获取云存储的区域信息,请勿修改此项。
OSS_ACCESS_KEY
process.env.OSS_ACCESS_KEY
用于获取云存储的用户名,请勿修改此项。
OSS_ACCESS_SECRET
process.env.OSS_ACCESS_SECRET
用于获取云存储的密码,请勿修改此项。
NODE_VERSION
process.env.NODE_VERSION
用于获取应用运行时的 Node.js
版本。
NODE_MODULES_PUSH_URL
process.env.NODE_MODULES_PUSH_URL
用于配置 node_modules.tar
缓存文件的下载地址,通常不需要修改。
默认应用的 node_modules
文件会缓存在应用自身的 cloud-bin
文件桶中,此环境变量的值为该文件桶的访问地址。
NODE_MODULES_PULL_URL
process.env.NODE_MODULES_PULL_URL
用于配置 node_modules.tar
缓存文件的上传地址,通常不需要修改。
默认应用的 node_modules
文件会缓存到应用自身的 cloud-bin
文件桶中,此环境变量的值为该文件桶的上传地址。
RESTART_AT
process.env.RESTART_AT
用于获取应用上一次重启的时间戳,其值形式如: 1703158202968
。