lazycat-dynamic-deploy

Original：🇨🇳 Chinese

Translated

A professional guide for handling dynamic deployment parameter configuration (lzc-deploy-params.yml), Go template rendering of manifest files, and front-end page script injection via application.injects for Lazycat MicroServer applications.

2installs

Sourcewhoamihappyhacking/lazycat-skills

Added on2026-03-24

NPX Install

npx skill4agent add whoamihappyhacking/lazycat-skills lazycat-dynamic-deploy

SKILL.md Content (Chinese)

View Translation Comparison →

Lazycat MicroServer Dynamic Deployment and Injection Guide

As a professional Lazycat MicroServer application architect, follow this guide when developers need to request custom configurations (such as passwords, remote IPs, etc.) from users, or need to force inject JavaScript scripts into the application's front-end pages without modifying the original application code.

1. Dynamic Deployment Parameters and Template Rendering (v1.3.8+)

Lazycat MicroServer supports popping up a UI interface for users to fill in parameters before installing an application, then using these parameters to dynamically render

lzc-manifest.yml

.

Step A: Write

lzc-deploy-params.yml

Create this file in the project root directory to define the fields that require user input.

yaml

params:
  - id: target_ip
    type: string
    name: "目标服务器 IP"
    description: "你要代理的内网服务器 IP"
  - id: enable_debug
    type: bool
    name: "开启 Debug"
    default_value: "false"
    optional: true

Supported types:

string

,

bool

,

secret

,

lzc_uid

Step B: Use Template Rendering in

lzc-manifest.yml

Use Go template syntax (

{{ ... }}

) to read parameters.

User parameters use

.U.parameterID

(e.g.,

{{ .U.target_ip }}

). If the ID contains

, use

index

(e.g.,

{{ index .U "my.param" }}

).

System parameters use
```
.S
```
(e.g.,
```
.S.BoxDomain
```
,
```
.S.IsMultiInstance
```
).
Random password generation function:
```
{{ stable_secret "admin_password" | substr 0 8 }}
```
(For the same microservice, the same seed will always generate the same string).

Example:

yaml

services:
  myapp:
    image: xxx
    environment:
      - REMOTE_IP={{ .U.target_ip }}
      - DB_PASS={{ stable_secret "db_root_pass" }}

2. Web Page Script Injection (

application.injects

) (v1.5.0+)

Suitable for force-injecting JS scripts into specific web pages without modifying the front-end code of third-party Docker images (e.g., to automatically fill in default passwords that are difficult to modify).

Core Logic: Only HTML pages that match the

include

(whitelist) and do not hit the

exclude

(blacklist) will be injected.

Example: Implement Auto-login for Third-party Systems

yaml

application:
  injects:
    - id: auto-login
      mode: exact # 支持 exact(精确) 或 prefix(前缀)
      include:
        - "/login"      # 当访问 /login 时注入
        - "/#signin"    # 也能匹配 hash 路由
      scripts:
        # 使用懒猫内置的表单填充脚本
        - src: builtin://simple-inject-password
          params:
            user: "admin"
            password: "{{ stable_secret "app_admin_pass" }}"
            autoSubmit: true

Custom Injection Scripts: If you want to inject your own script, you can place the JS file in the packaging directory and reference it via

file:///lzcapp/pkg/content/myscript.js

. Inside the script, you can get the passed

params

via

__LZC_INJECT_PARAMS__

.

Platform Compatibility Notes

For detailed lists of built-in template functions, system parameters (

SysParams

), or to learn about the detailed parameter configuration of the script injection's

builtin://simple-inject-password

(such as modifying selectors), please proactively read the relevant Markdown documents in the

references/

directory of this skill package.

lazycat-dynamic-deploy

NPX Install

Tags

SKILL.md Content (Chinese)

Lazycat MicroServer Dynamic Deployment and Injection Guide

1. Dynamic Deployment Parameters and Template Rendering (v1.3.8+)

Step A: Write
`lzc-deploy-params.yml`

Step B: Use Template Rendering in
`lzc-manifest.yml`

2. Web Page Script Injection (
`application.injects`
) (v1.5.0+)

Platform Compatibility Notes

lazycat-dynamic-deploy

NPX Install

Tags

SKILL.md Content (Chinese)

Lazycat MicroServer Dynamic Deployment and Injection Guide

1. Dynamic Deployment Parameters and Template Rendering (v1.3.8+)

Step A: Write lzc-deploy-params.yml

Step B: Use Template Rendering in lzc-manifest.yml

2. Web Page Script Injection (application.injects) (v1.5.0+)

Platform Compatibility Notes

Step A: Write
`lzc-deploy-params.yml`

Step B: Use Template Rendering in
`lzc-manifest.yml`

2. Web Page Script Injection (
`application.injects`
) (v1.5.0+)