LNbits部署指南：从本地测试到生产环境的完整流程

LNbits部署指南从本地测试到生产环境的完整流程【免费下载链接】lnbitsLNbits, free and open-source Lightning wallet and accounts system.项目地址: https://gitcode.com/gh_mirrors/ln/lnbitsLNbits是一款免费开源的Lightning钱包和账户系统本文将详细介绍从本地测试到生产环境部署的完整流程帮助新手和普通用户轻松搭建属于自己的LNbits服务。准备工作环境要求与前期准备在开始部署LNbits之前确保你的系统满足以下基本要求Python 3.12或更高版本Git工具网络连接至少1GB内存和10GB存储空间对于本地测试环境推荐使用Polar创建安全的本地Lightning网络环境避免影响真实资金。本地测试环境搭建快速上手体验选项1使用UV推荐开发者UV是LNbits推荐的快速安装工具步骤如下安装UVcurl -LsSf https://astral.sh/uv/install.sh | sh export PATH$HOME/.local/bin:$PATH克隆仓库并安装git clone https://gitcode.com/gh_mirrors/ln/lnbits cd lnbits git checkout main uv sync --all-extras cp .env.example .env启动本地服务器uv run lnbits --port 5000 --host 0.0.0.0选项2Docker快速部署如果你熟悉Docker这是最便捷的本地测试方式docker pull lnbits/lnbits wget https://raw.githubusercontent.com/lnbits/lnbits/main/.env.example -O .env mkdir data docker run --detach --publish 5000:5000 --name lnbits \ --volume ${PWD}/.env:/app/.env \ --volume ${PWD}/data/:/app/data \ lnbits/lnbits启动后访问 http://localhost:5000 即可看到LNbits的登录界面生产环境部署多种方案选择方案1Linux系统服务部署将LNbits配置为系统服务确保稳定运行创建系统服务文件sudo nano /etc/systemd/system/lnbits.service添加以下内容[Unit] DescriptionLNbits Afternetwork.target [Service] WorkingDirectory/home/youruser/lnbits ExecStart/home/youruser/.local/bin/uv run lnbits Useryouruser Restartalways RestartSec30 [Install] WantedBymulti-user.target启用并启动服务sudo systemctl enable lnbits.service sudo systemctl start lnbits.service方案2Docker生产环境配置为生产环境优化的Docker部署docker run --detach --publish 5000:5000 --name lnbits \ --volume ${PWD}/.env:/app/.env \ --volume ${PWD}/data/:/app/data \ -e LNBITS_EXTENSIONS_PATH/app/data/extensions \ lnbits/lnbits方案3Nix部署适合高级用户Nix提供了可靠的依赖管理适合追求稳定性的用户git clone https://gitcode.com/gh_mirrors/ln/lnbits cd lnbits nix build nix run安全配置HTTPS与反向代理生产环境必须配置HTTPS以确保安全推荐使用Caddy实现自动HTTPS安装Caddysudo apt install -y debian-keyring debian-archive-keyring apt-transport-https curl -1sLf https://dl.cloudsmith.io/public/caddy/stable/gpg.key | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg curl -1sLf https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt | sudo tee /etc/apt/sources.list.d/caddy-stable.list sudo apt update sudo apt install caddy配置Caddyfilesudo nano /etc/caddy/Caddyfile添加以下内容yourdomain.com { reverse_proxy 0.0.0.0:5000 { header_up X-Forwarded-Host yourdomain.com } }重启Caddysudo systemctl restart caddy数据库配置从SQLite到PostgreSQL默认情况下LNbits使用SQLite数据库适合小型部署。对于规模较大的生产环境建议迁移到PostgreSQL安装PostgreSQLsudo apt-get -y install postgresql创建数据库和用户sudo -i -u postgres psql ALTER USER postgres PASSWORD yourpassword; createdb lnbits \q exit配置LNbits使用PostgreSQLnano .env添加以下行LNBITS_DATABASE_URLpostgres://postgres:yourpasswordlocalhost:5432/lnbits迁移数据uv run python tools/conv.py移动设备访问响应式界面体验LNbits提供完全响应式的界面设计在移动设备上同样拥有出色的用户体验只需在移动浏览器中输入你的LNbits服务器地址即可随时随地管理你的Lightning钱包。维护与更新保持系统最新定期更新LNbits以获取最新功能和安全修复使用UV更新cd lnbits git pull --rebase uv sync --all-extras sudo systemctl restart lnbitsDocker更新docker pull lnbits/lnbits docker stop lnbits docker rm lnbits docker run --detach --publish 5000:5000 --name lnbits \ --volume ${PWD}/.env:/app/.env \ --volume ${PWD}/data/:/app/data \ lnbits/lnbits故障排除常见问题解决启动失败检查日志文件lnbits.log通常位于数据目录数据库连接问题验证.env文件中的数据库连接字符串依赖冲突使用uv sync --all-extras重新安装依赖端口占用使用netstat -tulpn检查端口占用情况修改启动端口总结选择适合你的部署方式无论你是想在本地测试LNbits功能还是搭建生产环境提供服务本文都提供了详细的部署指南。根据你的技术背景和需求选择最适合的部署方案新手用户推荐使用Docker方案简单快捷开发者UV安装方式提供更多灵活性生产环境系统服务PostgreSQLHTTPS是最佳组合LNbits的模块化设计让它可以适应各种使用场景从个人钱包到商业应用都能满足你的需求。开始你的LNbits之旅吧官方文档docs/guide/installation.md【免费下载链接】lnbitsLNbits, free and open-source Lightning wallet and accounts system.项目地址: https://gitcode.com/gh_mirrors/ln/lnbits创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考