脚本之家 服务器常用软件
快捷导航
您的位置：首页 → 网站技巧 → 服务器 → nginx → nginx 打包为 flatpak

如何将 Nginx 1.30.3 打包为 Flatpak 亲测100%成功

 更新时间：2026年07月06日 14:25:32   作者：肖坤超  
将Nginx 1.30.3成功打包为Flatpak的完整指南,100%亲测可行,立即学习如何彻底解决只读文件系统问题,轻松构建、安装并导出离线安装包,实现零权限错误的完美部署,点击获取最终文件清单和全部配置细节

将 Nginx 1.30.3 打包为 Flatpak 100%成功 亲测

最终文件清单（位于 ~/flatpak-nginx/）

~/flatpak-nginx/
├── nginx-1.30.3.tar.gz          # 源码包
├── nginx.conf                   # 配置文件（所有可写路径已强制修改）
├── launch.sh                    # 启动脚本（自动创建全部临时目录）
└── org.nginx.nginx.json         # Flatpak 构建清单（含可选 PCRE2 模块）

0. 准备工作

0.1 安装工具
sudo apt update && sudo apt install flatpak flatpak-builder wget -y
0.2 添加 Flathub（如已添加可跳过）
flatpak remote-add --user --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
0.3 安装 Freedesktop SDK 24.08
flatpak install --user org.freedesktop.Platform//24.08 org.freedesktop.Sdk//24.08 -y
0.4 下载 Nginx 源码并计算 SHA256
mkdir -p ~/flatpak-nginx && cd ~/flatpak-nginx
wget https://nginx.org/download/nginx-1.30.3.tar.gz
sha256sum nginx-1.30.3.tar.gz# 记录完整的十六进制哈希值

1. 编写 Nginx 配置文件（彻底解决只读问题）

文件： ~/flatpak-nginx/nginx.conf
要点： 所有日志、pid、临时目录全部强制指向沙箱内的可写路径 /var/tmp/nginx/，绝不触碰只读的 /app。
edit nginx ~/flatpak-nginx/nginx.conf

# /app/etc/nginx/nginx.conf
# 【调优1】自动匹配CPU核心数，充分利用多核性能
worker_processes  auto; 
# 【调优2】单进程可打开的最大文件数，防止高并发下报 "too many open files"
worker_rlimit_nofile 65535; 
pid /var/tmp/nginx/nginx.pid;
error_log /var/tmp/nginx/error.log info;   # 全局日志
events {
    # 【调优3】单进程最大连接数提升至 10240
    worker_connections  10240;
    # 【调优4】Linux下最优事件模型，处理万级连接无压力
    use epoll; 
    # 【调优5】允许一次接受多个连接，提升并发接收效率
    multi_accept on;
}
http {
    include       mime.types;
    default_type  application/octet-stream;
    client_body_temp_path /var/tmp/nginx/client_body_temp;
    proxy_temp_path       /var/tmp/nginx/proxy_temp;
    fastcgi_temp_path     /var/tmp/nginx/fastcgi_temp;
    uwsgi_temp_path       /var/tmp/nginx/uwsgi_temp;
    scgi_temp_path        /var/tmp/nginx/scgi_temp;
    # 【调优6】开启零拷贝传输，文件传输效率提升30%以上
    sendfile        on; 
    tcp_nopush      on;
    # 【调优7】长连接超时时间，减少TCP频繁握手
    keepalive_timeout  65;
    # 默认 server 块已注释，交由 sites/default.conf 统一管理，完美！
    # server {
    #    listen       8080;
    #    server_name  localhost;
    #    access_log  /var/tmp/nginx/access.log;
    #    error_log   /var/tmp/nginx/error.log;
    #    location / {
    #        root   /app/share/nginx/html;
    #        index  index.html index.htm;
    #    }
    #    error_page   500 502 503 504  /50x.html;
    #    location = /50x.html {
    #        root   /app/share/nginx/html;
    #    }
    # }
}

2. 编写启动脚本（自动创建全部目录）

文件： ~/flatpak-nginx/launch.sh
要点： 启动前强制创建所有临时子目录，确保 Nginx 不会因目录缺失而报错。
edit nginx ~/flatpak-nginx/launch.sh

#!/bin/bash
# 1. 定义用户专属目录
USER_BASE_DIR="$HOME/.var/app/org.nginx.nginx"
USER_CONF_DIR="$USER_BASE_DIR/config"
USER_LOG_DIR="$USER_BASE_DIR/logs"
USER_CONF_FILE="$USER_CONF_DIR/nginx.conf"
USER_MIME_FILE="$USER_CONF_DIR/mime.types"
# 2. 创建必要的目录结构
mkdir -p "$USER_CONF_DIR/sites" "$USER_CONF_DIR/conf.d" "$USER_LOG_DIR"
# 3. 首次运行：自动初始化配置文件
if [ ! -f "$USER_CONF_FILE" ]; then
    echo "First run: Generating default config..."
    cp /app/etc/nginx/nginx.conf "$USER_CONF_FILE"
    # 【关键】动态替换配置文件中的路径，避免沙箱只读报错
    # 替换 mime.types 为绝对路径
    sed -i "s|include       mime.types;|include       $USER_CONF_DIR/mime.types;|g" "$USER_CONF_FILE"
    # 替换默认的 conf.d 路径为绝对路径
    sed -i "s|include       conf.d/\*.conf;|include       $USER_CONF_DIR/conf.d/*.conf;|g" "$USER_CONF_FILE"
    # 将所有日志路径强制替换为用户的日志目录
    sed -i "s|/var/tmp/nginx/|$USER_LOG_DIR/|g" "$USER_CONF_FILE"
    # 【最佳实践】确保主配置中包含加载多网站的指令
    if ! grep -q "include.*sites/\*.conf" "$USER_CONF_FILE"; then
        echo "Adding sites include directive..."
        sed -i "/http {/a\\    include $USER_CONF_DIR/sites/*.conf;" "$USER_CONF_FILE"
    fi
fi
# 首次运行：复制 mime.types
if [ ! -f "$USER_MIME_FILE" ]; then
    cp /app/etc/nginx/mime.types "$USER_MIME_FILE"
fi
# 4. 【新增】首次运行：生成默认网站配置，确保用户进来有网页可看
if [ ! -f "$USER_CONF_DIR/sites/default.conf" ]; then
    echo "Generating default site config..."
    cat > "$USER_CONF_DIR/sites/default.conf" <<EOF
server {
    listen       8080;
    server_name  localhost;
    access_log  $USER_LOG_DIR/default.access.log;
    error_log   $USER_LOG_DIR/default.error.log;
    location / {
        root   /app/share/nginx/html;
        index  index.html index.htm;
    }
    error_page   500 502 503 504  /50x.html;
    location = /50x.html {
        root   /app/share/nginx/html;
    }
}
EOF
fi
# 5. 创建 Nginx 必须的临时目录（解决沙箱只读问题）
mkdir -p /var/tmp/nginx/client_body_temp \
         /var/tmp/nginx/proxy_temp \
         /var/tmp/nginx/fastcgi_temp \
         /var/tmp/nginx/uwsgi_temp \
         /var/tmp/nginx/scgi_temp
echo "Starting Nginx with config: $USER_CONF_FILE"
echo "Logs directory: $USER_LOG_DIR"
# 6. 启动 Nginx
echo "Starting Nginx with config: $USER_CONF_FILE"
echo "Logs directory: $USER_LOG_DIR"
echo ""
echo -e "\033[32m========================================\033[0m"
echo -e "\033[32m Nginx is running! You can visit:\033[0m"
echo -e "\033[32m http://127.0.0.1:8080\033[0m"
echo -e "\033[32m========================================\033[0m"
echo ""
# 启动 Nginx
exec /app/sbin/nginx -c "$USER_CONF_FILE" -g "daemon off;"

赋予执行权限：chmod +x ~/flatpak-nginx/launch.sh

3. 编写 Flatpak 构建清单

文件： ~/flatpak-nginx/org.nginx.nginx.json
将 <实际SHA256> 替换为第 0.4 步获得的哈希。
edit nginx ~/flatpak-nginx/org.nginx.nginx.json

3.1 推荐清单（SDK 已含 PCRE）

{
    "app-id": "org.nginx.nginx",
    "runtime": "org.freedesktop.Platform",
    "runtime-version": "24.08",
    "sdk": "org.freedesktop.Sdk",
    "command": "launch.sh",
    "finish-args": [
			"--share=network",
			"--filesystem=home",
			"--share=ipc"
    ],
    "modules": [
        {
            "name": "nginx",
            "buildsystem": "simple",
            "build-commands": [
                "./configure --prefix=/app --error-log-path=/var/tmp/nginx/error.log --http-log-path=/var/tmp/nginx/access.log --with-http_ssl_module --with-http_v2_module --with-http_realip_module --with-http_gzip_static_module",
    			"make -j$(nproc)",
    			"make install",
    			"install -Dm644 conf/mime.types /app/etc/nginx/mime.types",
    			"mkdir -p /app/share/nginx/html",
    			"echo '<h1>Welcome to Nginx in Flatpak!</h1><p>Edit your config in ~/.var/app/org.nginx.nginx/config/</p>' > /app/share/nginx/html/index.html"
            ],
            "sources": [
                {
                    "type": "archive",
                    "path": "nginx-1.30.3.tar.gz",
                    "sha256": "<实际SHA256>"
                }
            ]
        },
        {
            "name": "nginx-config",
            "buildsystem": "simple",
            "build-commands": [
                "install -Dm644 nginx.conf /app/etc/nginx/nginx.conf"
            ],
            "sources": [
                {
                    "type": "file",
                    "path": "nginx.conf"
                }
            ]
        },
        {
            "name": "launch-script",
            "buildsystem": "simple",
            "build-commands": [
                "install -Dm755 launch.sh /app/bin/launch.sh"
            ],
            "sources": [
                {
                    "type": "file",
                    "path": "launch.sh"
                }
            ]
        }
    ]
}

3.2 备用清单（当 PCRE 缺失时使用）
如果构建时提示 the HTTP rewrite module requires the PCRE library，请将整个 org.nginx.nginx.json 替换为以下内容（同样替换 SHA256）：

{
    "app-id": "org.nginx.nginx",
    "runtime": "org.freedesktop.Platform",
    "runtime-version": "24.08",
    "sdk": "org.freedesktop.Sdk",
    "command": "launch.sh",
    "finish-args": [
        "--share=network",
        "--filesystem=home",
        "--share=ipc"
    ],
    "modules": [
        {
            "name": "pcre2",
            "buildsystem": "simple",
            "build-commands": [
                "./configure --prefix=/app",
                "make -j$(nproc)",
                "make install"
            ],
            "sources": [
                {
                    "type": "archive",
                    "url": "https://github.com/PCRE2Project/pcre2/releases/download/pcre2-10.42/pcre2-10.42.tar.gz",
                    "sha256": "b29ba4a3b7e24615b75f29de8a2c7bf0a067ce83641c6a4964e51c4c60e5d0c6"
                }
            ]
        },
        {
            "name": "nginx",
            "buildsystem": "simple",
            "build-commands": [
                "./configure --prefix=/app --error-log-path=/var/tmp/nginx/error.log --http-log-path=/var/tmp/nginx/access.log --with-http_ssl_module --with-http_v2_module --with-http_realip_module --with-http_gzip_static_module",
    			"make -j$(nproc)",
    			"make install",
    			"install -Dm644 conf/mime.types /app/etc/nginx/mime.types",
    			"mkdir -p /app/share/nginx/html",
    			"echo '<h1>Welcome to Nginx in Flatpak!</h1><p>Edit your config in ~/.var/app/org.nginx.nginx/config/</p>' > /app/share/nginx/html/index.html"
            ],
            "sources": [
                {
                    "type": "archive",
                    "path": "nginx-1.30.3.tar.gz",
                    "sha256": "<实际SHA256>"
                }
            ]
        },
        {
            "name": "nginx-config",
            "buildsystem": "simple",
            "build-commands": [
                "install -Dm644 nginx.conf /app/etc/nginx/nginx.conf"
            ],
            "sources": [
                {
                    "type": "file",
                    "path": "nginx.conf"
                }
            ]
        },
        {
            "name": "launch-script",
            "buildsystem": "simple",
            "build-commands": [
                "install -Dm755 launch.sh /app/bin/launch.sh"
            ],
            "sources": [
                {
                    "type": "file",
                    "path": "launch.sh"
                }
            ]
        }
    ]
}

4. 构建、安装与完全清理

4.1 构建失败/重试前必须执行的完整清理

cd ~/flatpak-nginx && \
pkill -9 nginx 2>/dev/null || true && \
rm -rf build-dir && \
rm -rf ~/.cache/flatpak-builder/build/* && \
rm -rf ~/.cache/flatpak-builder/downloads/nginx-* \
       ~/.cache/flatpak-builder/downloads/pcre2-* && \
flatpak uninstall --user org.nginx.nginx -y 2>/dev/null || true && \
rm -rf ~/.local/share/flatpak/app/org.nginx.nginx \
       ~/.var/app/org.nginx.nginx

4.2 构建并安装flatpak-builder --user --install --force-clean build-dir org.nginx.nginx.json
4.3 导出离线安装包flatpak build-bundle ~/.local/share/flatpak/repo nginx.flatpak org.nginx.nginx

生成安装包的文件名是：nginx.flatpak，保存在你当前执行命令的目录下，把包发给别人

  1. 别人执行安装flatpak install --user nginx.flatpak
  2. 启动flatpak run org.nginx.nginx
  3. 验证http://localhost:8080

查看日志（无任何权限错误）
flatpak run --command=cat org.nginx.nginx /var/tmp/nginx/access.log
flatpak run --command=cat org.nginx.nginx /var/tmp/nginx/error.log

8. 故障排除与完全卸载

  • SHA256 不匹配： 重新计算并替换。
  • PCRE 缺失： 使用 3.2 备用清单。
  • 端口占用： sudo lsof -i :8080后 pkill -9 nginx 2>/dev/null || true

完全卸载：
flatpak uninstall --user org.nginx.nginx -y
rm -rf ~/flatpak-nginx/build-dir
rm -rf ~/.cache/flatpak-builder/build/nginx-* ~/.cache/flatpak-builder/build/pcre2-*
rm -rf ~/.cache/flatpak-builder/downloads/nginx-* ~/.cache/flatpak-builder/downloads/pcre2-*
rm -rf ~/.local/share/flatpak/app/org.nginx.nginx ~/.var/app/org.nginx.nginx
flatpak repair --user

到此这篇关于如何将 Nginx 1.30.3 打包为 Flatpak 亲测100%成功 的文章就介绍到这了,更多相关nginx 打包为 flatpak内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

相关文章

  • 深度详解什么是Nginx正向代理与反向代理

    深度详解什么是Nginx正向代理与反向代理

    这篇文章主要介绍了Nginx正向代理与Nginx反向代理的区别，比较易懂,需要的朋友可以参考下
    2023-03-03
  • nginx connect() to unix:/var/run/php-fpm.sock failed (11: Resource temporarily unavailable)

    nginx connect() to unix:/var/run/php-fpm.sock failed (11: Re

    这篇文章主要介绍了nginx connect() to unix:/var/run/php-fpm.sock failed (11: Resource temporarily unavailable),需要的朋友可以参考下
    2015-01-01
  • Nginx Stream模块详细攻略(四层代理的艺术与实践)

    Nginx Stream模块详细攻略(四层代理的艺术与实践)

    Nginx Stream模块是1.9.0版本引入的,用于处理TCP/UDP流量,提供四层网络代理功能,与HTTP模块相比,Stream模块工作在传输层,不解析应用协议,本文给大家介绍Nginx Stream模块完全指南：四层代理的艺术与实践,感兴趣的朋友一起看看吧
    2025-12-12
  • Nginx配置SSL证书的方法步骤

    Nginx配置SSL证书的方法步骤

    本文主要介绍了Nginx配置SSL证书,成功配置SSL证书后,您将能够通过HTTPS加密通道安全访问Nginx服务器,感兴趣的可以了解一下
    2024-02-02
  • Nginx本地目录映射实现代码实例

    Nginx本地目录映射实现代码实例

    这篇文章主要介绍了Nginx本地目录映射实现代码实例,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2020-10-10
  • Nginx更新SSL证书的实现步骤

    Nginx更新SSL证书的实现步骤

    本文主要介绍了Nginx更新SSL证书的实现步骤,包括下载新证书、备份旧证书、配置新证书、验证配置及遇到问题时的解决方法,感兴趣的了解一下
    2025-12-12
  • 使用Nginx为OpenClaw反向代理的实现

    使用Nginx为OpenClaw反向代理的实现

    本文详细介绍了如何通过Nginx反向代理配置OpenClaw网关的无域名HTTPS访问方案,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2026-04-04
  • nginx中的路径匹配location规则详解

    nginx中的路径匹配location规则详解

    Nginx的匹配规则用location指令来实现,Nginx 的location指令用于匹配请求的 URI（请求路径）,并根据匹配结果执行特定的处理指令,这篇文章主要介绍了nginx中的路径匹配规则详解（location规则）,需要的朋友可以参考下
    2025-04-04
  • nginx日志切割定时任务的实现

    nginx日志切割定时任务的实现

    Nginx日志切割能有效管理日志,便于查询、控制存储空间、提高处理效率、方便备份与归档,减少数据丢失风险,实现方法包括重命名日志文件、编写定时日志脚本和设置crontab定时任务
    2024-11-11
  • nginx的简单转发请求之server和location配置详解

    nginx的简单转发请求之server和location配置详解

    这篇文章主要介绍了nginx的简单转发请求之server和location配置详解，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
    2019-03-03

最新评论