本地部署开源发票管理系统 Invoice Ninja 并实现外部访问

Invoice Ninja 是一款开源的发票管理系统，它支持在线生成专业发票、报价单、收款记录和费用追踪，并提供客户端管理、自动提醒、多种支付网关集成以及多语言/多货币支持，专为自由职业者、中小企业和团队设计。本文将详细介绍如何利用 Docker 在局域网内部署 Invoice Ninja 并结合路由侠实现外网访问局域网内部署的 Invoice Ninja 。

第一步，本地部署安装 Invoice Ninja

1，本教程操作环境为 Linux Ubuntu 系统，Invoice Ninja 依赖 Docker 运行，我们需要先确保你的系统上已经安装了 Docker 。如果尚未安装，可以参考文档进行安装，点此查看。

2，安装 Docker Compose 。

复制代码

sudo curl -L "https://github.com/docker/compose/releases/download/$(curl -s https://api.github.com/repos/docker/compose/releases/latest | grep -Po '"tag_name": "\K.*\d')" /usr/local/bin/docker-compose

3，创建并进入项目目录。

复制代码

mkdir ninja-test && cd ninja-test

4，创建 docker-compose.yml 文件。

复制代码

sudo vim docker-compose.yml

写入以下内容：

复制代码

services:
  mysql:
    image: mysql:8.0
    container_name: ninja-mysql
    restart: unless-stopped
    environment:
      MYSQL_DATABASE: ninja
      MYSQL_USER: ninja
      MYSQL_PASSWORD: ninja
      MYSQL_ROOT_PASSWORD: root
    volumes:
      - mysql_data:/var/lib/mysql
    networks:
      - ninja-net

  redis:
    image: redis:alpine
    container_name: ninja-redis
    restart: unless-stopped
    volumes:
      - redis_data:/data
    networks:
      - ninja-net

  app:
    image: invoiceninja/invoiceninja:latest
    container_name: ninja-app
    restart: unless-stopped
    depends_on:
      - mysql
      - redis
    environment:
      APP_URL: http://localhost:8002
      APP_DEBUG: true
      REQUIRE_HTTPS: "false"
      DB_HOST: mysql
      DB_PORT: 3306
      DB_DATABASE: ninja
      DB_USERNAME: ninja
      DB_PASSWORD: ninja
      REDIS_HOST: redis
      REDIS_PORT: 6379
    volumes:
      - app_storage:/var/www/app/storage
    networks:
      - ninja-net

  nginx:
    image: nginx:alpine
    container_name: ninja-nginx
    restart: unless-stopped
    ports:
      - "8002:80"
    volumes:
      - ./nginx.conf:/etc/nginx/conf.d/default.conf:ro
    depends_on:
      - app
    networks:
      - ninja-net

volumes:
  mysql_data:
  redis_data:
  app_storage:

networks:
  ninja-net:
    driver: bridge

5，创建 nginx 配置。

复制代码

sudo vim nginx.conf

写入以下内容：

复制代码

server {
    listen 80;
    server_name _;
    root /var/www/app/public;
    index index.php;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        fastcgi_pass app:9000;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}

6，启动 Invoice Ninja 服务。

复制代码

docker-compose up -d

7，打开浏览器访问地址 http://你的服务器 IP:8002 ，就能看到你部署的 Invoice Ninja 登录界面了。

第二步，外网访问本地 Invoice Ninja

安装路由侠内网穿透。

1，当前未提供网页管理，需要先在任意一台 Windows 机器安装路由侠 Windows 版本，用作跨机器管理。点此下载

2，在路由侠客户端主界面，进入" 设备管理 "，点击右下角的" 添加设备 "，此时可查看到对应的安装码，此安装码用于将设备添加到对应账号下，可选中后复制。

3，直接下载后导入：

复制代码

wget https://dl.luyouxia.com:8443/v2/lyx-docker-x86_64.tar
docker load -i lyx-docker-x86_64.tar

4，然后使用该镜像启动容器。

复制代码

docker run --name lyx -it --restart=always --net=host -e code=这里填写安装码 luyouxia/lyx

5，此时，需要等待下载和安装的过程，如果一切正常，最终可以看到一些输出，并且可以看到如下提示：

复制代码

[Device] Logged in. Token: ....

这就表示安装成功了。

当前 Linux 终端这边，如果是使用的上面的命令，Docker 是运行在前台，此时可以按住 Ctrl + C ，退出路由侠，容器也将退出。现在可以使用以下命令将其放入后台持续运行：

复制代码

docker start lyx

注意如果容器删除，重新 docker run ，将创建为新的设备。

需要注意的是，因为容器参数已经添加了 --restart=always ，这样开机就会自动启动，不需要再手动启动路由侠了。

6，现在回到 Windows 这边设备列表，点击右上角的 × 返回主界面，再次进入，就可以找到这个设备，可以修改名称。

7，回到主界面，点击【内网映射】。

8，注意右上角的设备名称下拉框，这里选中刚刚添加的设备名称，此时在这个界面上添加的映射，就属于刚刚这个设备。添加或修改一般需要等待 30 秒，容器中的路由侠进程就会更新并加载。切换好设备后，点击【添加映射】。

9，选择【原生端口】。

10，在内网地址填写你的服务器 IP 和 Invoice Ninja 端口 8002 后点击【创建】按钮，如下图。

11，创建好后，就可以看到一条映射的公网地址，鼠标右键点击【复制地址】。

12，在外网电脑上，打开浏览器，在地址栏输入从路由侠生成的外网地址，就可以看到内网部署的 Invoice Ninja 登录界面了。