zip文件格式解析

The structure of a PKZip file

by Florian Buchholz

General structureLocal file headersData descriptorArchive decryption headerArchive extra data recordCentral directory

Printable Version

Overview

This document describes the on-disk structure of a PKZip (Zip) file. The documentation currently only describes the file layout format and meta information but does not address the actual compression or encryption of the file data itself. This documentation also does not discuss Zip archives that span multiple files in great detail. This documentation was created using the official documentation provided by PKWare Inc.

General structure

Each Zip file is structured in the following manner:

The archive consists of a series of local file descriptors, each containing a local file header, the actual compressed and/or encrypted data, as well as an optional data descriptor. Whether a data descriptor exists or not depends on a flag in the local file header.

Following the file descriptors is the archive decryption header, which only exists in PKZip file version 6.2 or greater. This header is only present if the central directory is encrypted and contains information about the encryption specification. The archive extra data record is also only for file of version 6.2 or greater and is not present in all Zip files. It is used in to support the encryption or compression of the central directory.

The central directory summarizes the local file descriptors and carries additional information regarding file attributes, file comments, location of the local headers, and multi-file archive information.

Local file headers

Each local file header has the following structure:

SignatureThe signature of the local file header. This is always '\x50\x4b\x03\x04'.VersionPKZip version needed to extractFlagsGeneral purpose bit flag:
Bit 00: encrypted file
Bit 01: compression option 
Bit 02: compression option 
Bit 03: data descriptor
Bit 04: enhanced deflation
Bit 05: compressed patched data
Bit 06: strong encryption
Bit 07-10: unused
Bit 11: language encoding
Bit 12: reserved
Bit 13: mask header values
Bit 14-15: reservedCompression method00: no compression
01: shrunk
02: reduced with compression factor 1
03: reduced with compression factor 2 
04: reduced with compression factor 3 
05: reduced with compression factor 4 
06: imploded
07: reserved
08: deflated
09: enhanced deflated
10: PKWare DCL imploded
11: reserved
12: compressed using BZIP2
13: reserved
14: LZMA
15-17: reserved
18: compressed using IBM TERSE
19: IBM LZ77 z
98: PPMd version I, Rev 1 File modification timestored in standard MS-DOS format:
Bits 00-04: seconds divided by 2 
Bits 05-10: minute
Bits 11-15: hourFile modification datestored in standard MS-DOS format:
Bits 00-04: day
Bits 05-08: month
Bits 09-15: years from 1980Crc-32 checksumvalue computed over file data by CRC-32 algorithm with 'magic number' 0xdebb20e3 (little endian)Compressed sizeif archive is in ZIP64 format, this filed is 0xffffffff and the length is stored in the extra fieldUncompressed sizeif archive is in ZIP64 format, this filed is 0xffffffff and the length is stored in the extra fieldFile name lengththe length of the file name field belowExtra field lengththe length of the extra field belowFile namethe name of the file including an optional relative path. All slashes in the path should be forward slashes '/'.Extra fieldUsed to store additional information. The field consistes of a sequence of header and data pairs, where the header has a 2 byte identifier and a 2 byte data size field.

Example

Our sample zip file starts with a local file header:

00000000  50 4b 03 04 14 00 00 00  08 00 1c 7d 4b 35 a6 e1  |PK.........}K5..|00000010  90 7d 45 00 00 00 4a 00  00 00 05 00 15 00 66 69  |.}E...J.......fi|00000020  6c 65 31 55 54 09 00 03  c7 48 2d 45 c7 48 2d 45  |le1UT....H-E.H-E|00000030  55 78 04 00 f5 01 f5 01  0b c9 c8 2c 56 00 a2 92  |Ux.........,V...|

This results in the following fields and field values:

Signature'\x50\x4b\x03\x04'.Version0x14 = 20 -> 2.0Flagsno flagsCompression method08: deflatedFile modification time0x7d1c = 0111110100011100 
hour = (01111)10100011100 = 15 
minute = 01111(101000)11100 = 40
second = 01111101000(11100) = 28 = 56 seconds 
15:40:56File modification date0x354b = 0011010101001011
year = (0011010)101001011 = 26
month = 0011010(1010)01011 = 10
day = 00110101010(01011) = 11 
10/11/2006Crc-32 checksum0x7d90e1a6Compressed size0x45 = 69 bytesUncompressed size0x4a = 74 bytesFile name length5 bytesExtra field length21 bytesFile name"file1"Extra fieldid 0x5455: extended timestamp, size: 9 bytes 
Id 0x7855: Info-ZIP UNIX, size: 4 bytes

Data descriptor

The data descriptor is only present if bit 3 of the bit flag field is set. In this case, the CRC-32, compressed size, and uncompressed size fields in the local header are set to zero. The data descriptor field is byte aligned and immediately follows the file data. The structure is as follows:

The example file does not contain a data descriptor.

Archive decryption header

This header is used to support the Central Directory Encryption Feature. It is present when the central directory is encrypted. The format of this data record is identical to the Decryption header record preceding compressed file data.

Archive extra data record

This header is used to support the Central Directory Encryption Feature. When present, this record immediately precedes the central directory data structure. The size of this data record will be included in the Size of the Central Directory field in the End of Central Directory record. The structure is as follows:

Central directory

The central directory contains more metadata about the files in the archive and also contains encryption information and information about Zip64 (64-bit zip archives) archives. Furthermore, the central directory contains information about archives that span multiple files. The structure of the central directory is as follows:

The file headers are similar to the local file headers, but contain some extra information. The Zip64 entries handle the case of a 64-bit Zip archive, and the end of the central directory record contains information about the archive itself.

Central directory file header

The structure of the file header in the central directory is as follows:

SignatureThe signature of the file header. This is always '\x50\x4b\x01\x02'.VersionVersion made by:

upper byte: 
0 - MS-DOS and OS/2 (FAT / VFAT / FAT32 file systems)
1 - Amiga 
2 - OpenVMS
3 - UNIX 
4 - VM/CMS
5 - Atari ST
6 - OS/2 H.P.F.S.
7 - Macintosh 
8 - Z-System
9 - CP/M 
10 - Windows NTFS
11 - MVS (OS/390 - Z/OS) 
12 - VSE
13 - Acorn Risc 
14 - VFAT
15 - alternate MVS 
16 - BeOS
17 - Tandem 
18 - OS/400
19 - OS/X (Darwin) 
20 - 255: unused

lower byte:
zip specification versionVers. needed

PKZip version needed to extract

FlagsGeneral purpose bit flag:
Bit 00: encrypted file
Bit 01: compression option 
Bit 02: compression option 
Bit 03: data descriptor
Bit 04: enhanced deflation
Bit 05: compressed patched data
Bit 06: strong encryption
Bit 07-10: unused
Bit 11: language encoding
Bit 12: reserved
Bit 13: mask header values
Bit 14-15: reservedCompression method00: no compression
01: shrunk
02: reduced with compression factor 1
03: reduced with compression factor 2 
04: reduced with compression factor 3 
05: reduced with compression factor 4 
06: imploded
07: reserved
08: deflated
09: enhanced deflated
10: PKWare DCL imploded
11: reserved
12: compressed using BZIP2
13: reserved
14: LZMA
15-17: reserved
18: compressed using IBM TERSE
19: IBM LZ77 z
98: PPMd version I, Rev 1 File modification timestored in standard MS-DOS format:
Bits 00-04: seconds divided by 2 
Bits 05-10: minute
Bits 11-15: hourFile modification datestored in standard MS-DOS format:
Bits 00-04: day
Bits 05-08: month
Bits 09-15: years from 1980Crc-32 checksumvalue computed over file data by CRC-32 algorithm with 'magic number' 0xdebb20e3 (little endian)Compressed sizeif archive is in ZIP64 format, this filed is 0xffffffff and the length is stored in the extra fieldUncompressed sizeif archive is in ZIP64 format, this filed is 0xffffffff and the length is stored in the extra fieldFile name lengththe length of the file name field belowExtra field lengththe length of the extra field belowFile comm. lenthe length of the file commentDisk # startthe number of the disk on which this file existsInternal attr.

Internal file attributes:
Bit 0: apparent ASCII/text file
Bit 1: reserved
Bit 2: control field records precede logical records
Bits 3-16: unused

External attr.External file attributes:
host-system dependentOffset of local headerRelative offset of local header. This is the offset of where to find the corresponding local file header from the start of the first disk.File namethe name of the file including an optional relative path. All slashes in the path should be forward slashes '/'.Extra fieldUsed to store additional information. The field consistes of a sequence of header and data pairs, where the header has a 2 byte identifier and a 2 byte data size field.File commentAn optional comment for the file.

Example:

The corresponding file header from our local file header example above starts at byte 0x9a2 in the example file:

000009a0  28 f0 50 4b 01 02 17 03  14 00 00 00 08 00 1c 7d  |(.PK...........}|000009b0  4b 35 a6 e1 90 7d 45 00  00 00 4a 00 00 00 05 00  |K5...}E...J.....|000009c0  0d 00 1c 00 00 00 01 00  00 00 a4 81 00 00 00 00  |................|000009d0  66 69 6c 65 31 55 54 05  00 03 c7 48 2d 45 55 78  |file1UT....H-EUx|000009e0  00 00 74 68 69 73 20 69  73 20 61 20 63 6f 6d 6d  |..this is a comm|000009f0  65 6e 74 20 66 6f 72 20  66 69 6c 65 20 31 50 4b  |ent for file 1PK|

Signature'\x50\x4b\x01\x02'.Version0x0317
upper byte: 03 -> UNIX
lower byte: 23 -> 2.3Version needed0x14 = 20 -> 2.0Flagsno flagsCompression method08: deflatedFile modification time0x7d1c = 0111110100011100 
hour = (01111)10100011100 = 15 
minute = 01111(101000)11100 = 40
second = 01111101000(11100) = 28 = 56 seconds 
15:40:56File modification date0x354b = 0011010101001011
year = (0011010)101001011 = 26
month = 0011010(1010)01011 = 10
day = 00110101010(01011) = 11 
10/11/2006Crc-32 checksum0x7d90e1a6Compressed size0x45 = 69 bytesUncompressed size0x4a = 74 bytesFile name length5 bytesExtra field length13 bytesFile comment length28 bytesDisk # start0Internal attributesBit 0 set: ASCII/text fileExternal attributes0x81a40000Offset of local header0File name"file1"Extra fieldid 0x5455: extended timestamp, size: 5 bytes 
Id 0x7855: Info-ZIP UNIX, size: 0 bytesFile comment"this is a comment for file 1"

End of central directory record

The structure of the end of central directory record is as follows:

SignatureThe signature of end of central directory record. This is always '\x50\x4b\x05\x06'.Disk NumberThe number of this disk (containing the end of central directory record)Disk # w/cdNumber of the disk on which the central directory startsDisk entriesThe number of central directory entries on this diskTotal entriesTotal number of entries in the central directory.Central directory sizeSize of the central directory in bytesOffset of cd wrt to starting diskOffset of the start of the central directory on the disk on which the central directory startsComment lenThe length of the following comment fieldZIP file commentOptional comment for the Zip file

Example:

The end of central directory in out example file starts at byte 0xb36:

00000b30  6f 6d 6d 65 6e 74 50 4b  05 06 00 00 00 00 04 00  |ommentPK........|00000b40  04 00 94 01 00 00 a2 09  00 00 33 00 74 68 69 73  |..........3.this|00000b50  20 69 73 20 61 0d 0a 6d  75 6c 74 69 6c 69 6e 65  | is a..multiline|00000b60  20 63 6f 6d 6d 65 6e 74  20 66 6f 72 20 74 68 65  | comment for the|00000b70  20 65 6e 74 69 72 65 20  61 72 63 68 69 76 65     | entire archive|

Signature'\x50\x4b\x05\x06'.Disk Number0Disk # w/cd0Disk entries4Total entries4Central directory size0x194 = 404 bytesOffset of cd wrt to starting diskbyte 0x9a2 = byte 2466Comment len0x33 = 51 bytesZIP file comment"this is a
multiline comment for the entire archive"