Compile Docker images into standalone portable binaries

Estimated read time 15 min read


Dockerc is a container image compiler that can compile Docker container images into independent portable binaries. This means that users no longer need to use docker runcommands to run containers, nor use pip installor npm ito install packages, but can directly run compiled executable files.

The compiled binary can be called like a normal binary. Additionally, when network services run inside a container, users can access them directly without specifying -pparameters to map ports.

This project is useful for users who want to simplify container deployment and management, especially those who want to avoid the complexity of Docker command line operations.

Install webman

composer create-project workerman/webman tinywan-docker-webman

Download PHP binaries


Unzip it to get a PHP executable file, which can be used directly without installing a PHP environment. Currently only Linux systems are supported. Usually x86_64the schema is downloaded. download link

After decompression, a binary PHP file will be generated

tar -zxvf php-8.2.8-static-bin-x86_64.tar.gz

View version

./php -v
PHP 8.2.8 (cli) (built: Aug 10 2023 13:02:26) (NTS)
Copyright (c) The PHP Group
Zend Engine v4.2.8, Copyright (c) Zend Technologies

Build Docker image


FROM alpine:latest

RUN sed -i "s/" /etc/apk/repositories

RUN apk update && 
    apk --no-cache upgrade && 
    rm -rf /var/cache/apk/* && 
    mkdir -p /app/opcache


COPY ./ /app/
# 直接使用 PHP 静态二进制文件
RUN mv /app/php /usr/local/bin/php && chmod +x /usr/local/bin/php


CMD ["php", "-c", "php.ini", "start.php", "start"]

php.ini configuration file


Build image

docker build . -t tinywan/webman:8.2.8 --load

Output results

[+] Building 3.7s (11/11) FINISHED                                                                                            docker:default
 => [internal] load build definition from Dockerfile                                                                                    0.0s
 => => transferring dockerfile: 436B                                                                                                    0.0s
 => [internal] load metadata for                                                                        0.2s
 => [internal] load .dockerignore                                                                                                       0.0s
 => => transferring context: 2B                                                                                                         0.0s
 => [1/6] FROM                  0.0s
 => [internal] load build context                                                                                                       0.3s
 => => transferring context: 30.72MB                                                                                                    0.3s
 => CACHED [2/6] RUN sed -i "s/" /etc/apk/repositories                                       0.0s
 => CACHED [3/6] RUN apk update &&     apk --no-cache upgrade &&     rm -rf /var/cache/apk/* &&     mkdir -p /app/opcache               0.0s
 => CACHED [4/6] WORKDIR /app                                                                                                           0.0s
 => [5/6] COPY ./ /app/                                                                                                                 0.7s
 => [6/6] RUN mv /app/php /usr/local/bin/php && chmod +x /usr/local/bin/php                                                             2.1s
 => exporting to image                                                                                                                  0.3s
 => => exporting layers                                                                                                                 0.3s
 => => writing image sha256:45de23415b779b5660070e8035667dca0b5b389d2e229ad4a7092d9e650370c5                                            0.0s
 => => naming to  

View image

# docker images

REPOSITORY                  TAG                IMAGE ID       CREATED              SIZE
tinywan/webman              8.2.8              45de23415b77   About a minute ago   71MB

Download dockerc

chmod u+x dockerc

Use dockerc to export the image as a binary file

./dockerc --image docker-daemon:tinywan/webman:8.2.8 --output webman.bin

The following results are output to indicate successful export.

Getting image source signatures
Copying blob a31c5b53afbf done   | 
Copying blob 8d3ac3489996 done   | 
Copying blob 3a1eb8879fac done   | 
Copying blob fca36167c75a done   | 
Copying blob 5f70bf18a086 done   | 
Copying blob b9b78906a59e done   | 
Copying config 2678f4ef97 done   | 
Writing manifest to image destination
Parallel mksquashfs: Using 2 processors
Creating 4.0 filesystem on webman.bin, block size 131072.
[============================================================================================================================|] 671/671 100%

Exportable Squashfs 4.0 filesystem, zstd compressed, data block size 131072
 compressed data, compressed metadata, compressed fragments,
 compressed xattrs, compressed ids
 duplicates are removed
Filesystem size 11344.11 Kbytes (11.08 Mbytes)
 31.87% of uncompressed filesystem size (35594.23 Kbytes)
Inode table size 6844 bytes (6.68 Kbytes)
 21.11% of uncompressed inode table size (32419 bytes)
Directory table size 9080 bytes (8.87 Kbytes)
 46.37% of uncompressed directory table size (19580 bytes)
Xattr table size 36 bytes (0.04 Kbytes)
 112.50% of uncompressed xattr table size (32 bytes)
Number of duplicate files found 10
Number of inodes 911
Number of files 414
Number of fragments 17
Number of symbolic links 331
Number of device nodes 0
Number of fifo nodes 0
Number of socket nodes 0
Number of directories 166
Number of hard-links 0
Number of ids (unique uids + gids) 1
Number of uids 1
 root (0)
Number of gids 1
 root (0)

Execute binary file

# ./webman.bin 

unknown argument ignored: lazytime
Workerman[start.php] start in DEBUG mode
------------------------------------------- WORKERMAN -------------------------------------------
Workerman version:4.1.15          PHP version:8.2.8           Event-Loop:WorkermanEventsEvent
-------------------------------------------- WORKERS --------------------------------------------
proto   user            worker          listen                 processes    status           
tcp     root            webman    8             [OK]            
tcp     root            monitor         none                   1             [OK]            
Press Ctrl+C to stop. Start success.

You May Also Like

More From Author

+ There are no comments

Add yours