Dịch vụ Kiểm soát Phiên bản Cục bộ

Updated: May 21, 2026 | Applies to version: 7.1

Cài đặt Enterprise Server cung cấp khả năng kiểm soát phiên bản được bản địa hóa (và tập trung), nhờ vào dịch vụ Version Control của nó. Dịch vụ này mang đến các khả năng kiểm soát phiên bản ngay tại nơi bạn cần, cục bộ, mà không cần tìm kiếm hoặc trả phí cho phần mềm quản lý VCS bên ngoài.

Bằng cách định nghĩa các kho thiết kế theo cách tập trung này, một tổ chức có thể kiểm soát hoàn toàn những kho nào mà các nhà thiết kế của mình có thể truy cập và sử dụng.

Relevance of the information on this page:

Một bản cài đặt Enterprise Server mới cung cấp một kho thiết kế duy nhất dựa trên Git để chứa toàn bộ các dự án thiết kế trong Workspace của bạn – và chỉ vậy thôi! Điều này giúp tránh mọi thiết lập và độ phức tạp liên quan đến dịch vụ Version Control cục bộ của Enterprise Server. Bạn có một kho thiết kế duy nhất – Versioned Storage – để tất cả nhà thiết kế của bạn truy cập và phát hành vào đó. Vì vậy, trang VCS trong giao diện trình duyệt của Workspace trở thành trang chỉ mang tính thông tin – bạn không thể thêm kho mới, và kho Git duy nhất cũng không thể bị chỉnh sửa theo bất kỳ cách nào, cũng như không thể bị xóa. Do đó, thông tin trên trang này không áp dụng cho bạn.

Nếu bạn đã nâng cấp Enterprise Server từ một phiên bản hoặc sản phẩm máy chủ nơi việc sử dụng các kho SVN được bật, thì chúng vẫn sẽ được bật sau khi nâng cấp (vui lòng đảm bảo rằng bạn làm mới giấy phép Altium On-Prem Enterprise Server của mình). Điều này cho phép bạn tiếp tục sử dụng quy trình thiết kế trước đây (và đã được thiết lập). Trong trường hợp này, bạn có thể tiếp tục tạo kho thông qua dịch vụ Version Control cục bộ (chỉ SVN), hoặc kết nối tới các kho bên ngoài (SVN hoặc Git). Vì vậy, thông tin trên trang này vẫn còn phù hợp với bạn.

Important: Lưu ý rằng nếu không thuộc trường hợp đó, nút sẽ bị làm mờ, và khả năng tạo/thêm kho sẽ không khả dụng.

Để biết thêm thông tin về Design Repositories, và cách làm việc với chúng thông qua Altium Designer, xem Using External Version Control.

Các ưu điểm chính

Có hai ưu điểm chính khi sử dụng dịch vụ Version Control tập trung này:

Bạn có cơ chế quản lý người dùng và quyền dùng chung cho cả Altium Designer và SVN. Khi bạn đăng nhập vào Enterprise Server, dịch vụ Version Control sẽ hoạt động với phiên/thông tin xác thực của bạn.
Các kho được định nghĩa thông qua Enterprise Server (thông qua trang VCS (Admin – VCS) trong giao diện Workspace trên trình duyệt của Enterprise Server) sẽ được tự động đưa vào Altium Designer trong quá trình đăng nhập, vì vậy người dùng không cần phải lo về URL, giao thức, mật khẩu, v.v. Mọi thứ chỉ cần được cấu hình một lần trên Enterprise Server, rồi chia sẻ với những người dùng được chỉ định khi cần.

Khi một người dùng mới cho Enterprise Server được tạo, Password đã định nghĩa cho người dùng đó sẽ được lưu trong cả Enterprise Server và dịch vụ SVN, vì dịch vụ sau không thể truy cập trực tiếp mật khẩu từ dịch vụ trước.

Tạo kho

Các kho có thể được tạo thông qua dịch vụ Version Control cục bộ (chỉ SVN), hoặc có thể kết nối đến các kho bên ngoài (SVN hoặc Git). Tổng hợp lại, tất cả các kho đều được quản lý tập trung qua trang VCS (Admin – VCS) trong giao diện Workspace trên trình duyệt, xét theo các khía cạnh:

Tên hiển thị, mô tả và đường dẫn kho của chúng.
Khả năng truy cập đã cấu hình – cụ thể người dùng nào có thể truy cập chúng (hoặc các nhóm, trong trường hợp kho được định nghĩa thông qua dịch vụ Version Control cục bộ).
Tính sẵn sàng – thêm hoặc xóa chúng theo cách tập trung, thay vì từng nhà thiết kế phải tự tạo và kết nối kho một cách độc lập.

Mặc định có sẵn hai Design Repository, do dịch vụ Version Control cục bộ cung cấp và lần lượt có tên là DefaultRepository (một kho SVN) và Versioned Storage (một kho Git). Kho DefaultRepository không thể đổi tên, nhưng bạn có thể thêm mô tả cho nó, quản lý quyền truy cập của người dùng vào nó, hoặc xóa nó nếu cần. Kho Versioned Storage, vốn chỉ dùng cho lưu trữ tích hợp các dự án Workspace, không thể đổi tên, chia sẻ hoặc xóa.

Khi một người dùng Altium Designer đăng nhập vào Workspace, các Design Repository khả dụng cho họ sẽ tự động được thêm vào trang Data Management – Design Repositories page của hộp thoại Preferences. Lưu ý rằng danh sách này cũng sẽ bao gồm mọi kho 'không được quản lý' đã được thêm thủ công từ trang Preferences này.

Xác định tập trung quyền truy cập vào các Design Repository của tổ chức bạn. Các kho có thể là nội bộ trong bản cài đặt Enterprise Server, được định nghĩa bằng dịch vụ Version Control cục bộ, hoặc là bên ngoài thông qua SVN tích hợp sẵn của Altium Designer, hoặc dịch vụ SVN hay Git của bên thứ ba. Việc kiểm soát truy cập được thực hiện qua trang VCS trong giao diện Workspace trên trình duyệt. Khi một người dùng đăng nhập vào Workspace, các Design Repository khả dụng cho họ sẽ tự động được thêm vào trang Data Management – Design Repositories của hộp thoại Preferences .

Thêm kho

Để thêm một Design Repository, nhấp vào nút , nằm ở góc trên bên phải của trang. Cửa sổ Add Repository sẽ xuất hiện, hãy dùng nó để định nghĩa kho.

Chỉ các kho kiểu SVN mới có thể được tạo thông qua dịch vụ Version Control cục bộ. Có thể liên kết tới các kho hiện có (bên ngoài), và các kho này có thể là SVN hoặc Git.

Các thuộc tính cần thiết sẽ phụ thuộc vào việc bạn đang tạo kho mới bằng dịch vụ Version Control cục bộ, hay liên kết tới một kho bên ngoài đã tồn tại:

New – đặt tên và mô tả cho kho.
Existing – ngoài tên và mô tả, bạn cần cung cấp URL tới kho đó, cùng với thông tin xác thực hợp lệ (User Name, Password) để truy cập kho đó (nếu cần).

Khi tạo một kho nội bộ trong Enterprise Server, tên phải bắt đầu bằng, và chỉ có thể chứa A-Z, a-z, hoặc 0-9. Dấu gạch dưới, dấu gạch ngang và khoảng trắng được phép xuất hiện ở giữa tên. Bạn không thể sử dụng các từ sau: AUX, COM1-COM9, LPT1-LPT9, CON, NUL, và PRN. Không có giới hạn đặt tên đối với kho bên ngoài.

Tạo một Design Repository mới dựa trên SVN thông qua dịch vụ Version Control cục bộ của Enterprise Server, hoặc liên kết tới một kho hiện có (SVN hoặc Git) đã được tạo bên ngoài Enterprise Server.

Một Design Repository liên kết bên ngoài được phân biệt trong danh sách kho bằng thuộc tính External của nó được đánh dấu ().

Để chỉnh sửa các thuộc tính của một Design Repository ở giai đoạn sau, nhấp vào điều khiển Edit liên quan của nó (). Để xóa một Design Repository, nhấp vào điều khiển Remove liên quan của nó ().

Danh sách kho được tự động sắp xếp theo thứ tự chữ cái theo Name, với các kho cục bộ được định nghĩa qua dịch vụ Version Control được liệt kê trước, sau đó mới đến các kho bên ngoài. Kho Versioned Storage dựa trên Git – không thể chỉnh sửa hoặc xóa – luôn xuất hiện ở đầu danh sách.

Chia sẻ kho

Sau khi đã tập trung hóa các Design Repository của mình, bạn cần đảm bảo rằng những người cần truy cập vào một kho nhất định – bao gồm các nhà thiết kế sẽ làm việc trên các thiết kế bo mạch – có quyền truy cập đó. Điều này được thực hiện bằng cách chia sẻ kho đó, hay chính xác hơn là quản lý các quyền truy cập của nó. Để làm điều này, hãy nhấp vào điều khiển Share liên quan của kho ().

Cửa sổ Manage Permissions sẽ xuất hiện, với tất cả các điều khiển cần thiết để chia sẻ kho với những người dùng khác.

Khi Design Repositories được tổ chức tập trung, việc chia sẻ với người khác đơn giản chỉ là quản lý quyền của từng kho.

Những điều cần lưu ý:

Đối với kho cục bộ được tạo thông qua dịch vụ Version Control của Enterprise Server (tức là không phải kho bên ngoài), quyền mặc định của nó sẽ chia sẻ kho đó với người dùng đã tạo kho và nhóm Administrators. Cả hai đều có toàn quyền Đọc/Ghi.
Đối với kho bên ngoài, mặc định nó sẽ không được chia sẻ với bất kỳ ai – kể cả người dùng đã thêm kết nối tới nó thông qua giao diện.
Chỉ các kho cục bộ (không phải kho bên ngoài) mới có thể được chia sẻ với các nhóm đã định nghĩa cho Enterprise Server, hoặc chia sẻ công khai. Các nhóm được liệt kê sau từng người dùng riêng lẻ.
Về mặt quyền hạn, một người dùng/nhóm có quyền Đọc/Ghi khi tùy chọn Can Write được bật (). Nếu tùy chọn này bị tắt, họ chỉ có quyền Đọc.

Be Aware: Các thiết lập quyền khi chia sẻ một kho thiết kế nội bộ hiện không hoạt động hoàn toàn đúng như mong đợi. Mặc dù bản thân một kho thiết kế nội bộ có thể được chia sẻ ở chế độ chỉ Đọc với một người dùng máy chủ, người dùng đó vẫn có thể tạo các dự án Workspace MỚI trong kho đó, và nhận đầy đủ quyền Đọc/Ghi đối với các thư mục dự án tương ứng được tạo ra. Lưu ý rằng chức năng sai lệch này chỉ áp dụng cho các dự án Workspace mới và các thư mục của chúng, do chính người dùng đó tạo ra. Người dùng sẽ không có quyền Ghi đối với các thư mục khác trong kho.

Để xóa một người dùng/nhóm hiện có khỏi quyền truy cập đã chia sẻ vào một kho, nhấp vào điều khiển Remove liên quan ().

Sharing a Local Repository with a Workspace User

Để chia sẻ một kho cục bộ (không phải kho bên ngoài) với một người dùng Workspace khác:

Nhấp vào điều khiển Add User trong cửa sổ Manage Permissions.

Trong cửa sổ Add Users xuất hiện, bắt đầu nhập họ tên đầy đủ, tên người dùng hoặc địa chỉ email của một người dùng Workspace vào trường Select Users to be added, để hiện danh sách các người dùng phù hợp. Chọn người dùng cần thiết từ danh sách này. Có thể chọn nhiều người dùng. Để xóa một người dùng, nhấp vào dấu xóa ở bên phải tên của họ.

Thiết lập quyền cho (các) người dùng bằng trường Permission. Dùng danh sách thả xuống để chọn giữa quyền truy cập Read hoặc quyền truy cập Read/Write.

Nhấp vào nút để xác nhận việc thêm người dùng và quay lại cửa sổ Manage Permissions.

Nhấp vào nút trong cửa sổ Manage Permissions.

Để chỉnh sửa quyền cho một người dùng hiện có, dùng tùy chọn Can Write trong cửa sổ Manage Permissions, để chuyển đổi giữa quyền Đọc/Ghi (bật) hoặc chỉ Đọc (tắt).

Sharing a Local Repository with a defined Group

Nếu kho đã được tạo thông qua dịch vụ Version Control cục bộ, thay vì là kho bên ngoài, thì bạn cũng có thể chia sẻ với các nhóm đã được định nghĩa cho Workspace của bạn. Để chia sẻ một kho cục bộ (không phải kho bên ngoài) với một nhóm khác:

Nhấp vào điều khiển Add Group trong cửa sổ Manage Permissions.

Trong cửa sổ Add Groups xuất hiện, bắt đầu nhập tên nhóm vào trường Select Groups to be added, để hiện danh sách các nhóm phù hợp. Chọn nhóm cần thiết từ danh sách này. Có thể chọn nhiều nhóm. Để xóa một nhóm, nhấp vào dấu xóa ở bên phải tên của nhóm đó.

Thiết lập quyền cho (các) nhóm bằng trường Permission. Dùng danh sách thả xuống để chọn giữa quyền truy cập Read hoặc quyền truy cập Read/Write.

Nhấp vào nút để xác nhận việc thêm nhóm và quay lại cửa sổ Manage Permissions.

Nhấp vào nút trong cửa sổ Manage Permissions.

Để chỉnh sửa quyền cho một nhóm hiện có, dùng tùy chọn Can Write trong cửa sổ Manage Permissions, để chuyển đổi giữa quyền Đọc/Ghi (bật) hoặc chỉ Đọc (tắt).

Sharing a Local Repository with All Users

Nếu kho đã được tạo thông qua dịch vụ Version Control cục bộ, thay vì là kho bên ngoài, thì bạn cũng có thể chia sẻ kho đó với tất cả người dùng Workspace. Để chia sẻ một kho cục bộ (không phải kho bên ngoài) với bất kỳ ai có thể đăng nhập vào Workspace:

Nhấp vào điều khiển Add Anyone trong cửa sổ Manage Permissions.

Mục Anyone sẽ được thêm trực tiếp vào danh sách các thực thể được chia sẻ, và tự động được chia sẻ với quyền Đọc/Ghi.

Nhấp vào nút trong cửa sổ Manage Permissions.

Để chỉnh sửa quyền cho thực thể Anyone, dùng tùy chọn Can Write trong cửa sổ Manage Permissions, để chuyển đổi giữa quyền Đọc/Ghi (bật) hoặc chỉ Đọc (tắt).

Sharing an External Repository with a Workspace User

Để chia sẻ một kho bên ngoài với một người dùng Workspace:

Nhấp vào điều khiển Add User trong cửa sổ Manage Permissions.

Trong cửa sổ Add Users xuất hiện, bắt đầu nhập họ tên đầy đủ, tên người dùng hoặc địa chỉ email của một người dùng Workspace vào trường Select Users to be added, để hiện danh sách các người dùng phù hợp. Chọn người dùng cần thiết từ danh sách này. Để xóa người dùng, nhấp vào dấu xóa ở bên phải tên của họ.
Trong trường SVN User, nhập tên đã được đăng ký với kho bên ngoài (SVN hoặc Git) và vì vậy có quyền truy cập. Thông thường, đây sẽ là tên tương ứng của người dùng đã đăng ký với kho

Nhấp vào nút để xác nhận việc thêm người dùng và quay lại cửa sổ Manage Permissions. Nhấp Add User để thêm những người dùng khác như đã nêu ở bước 2 ở trên. Lưu ý rằng trong hình ví dụ thứ hai bên dưới, người dùng Barry đã được thiết lập để dùng tên kho tương ứng của anh ấy là BarrySmith, thay vì tên chung ServerAdmin.

Nhấp vào nút trong cửa sổ Manage Permissions.

Người dùng Workspace có thể được ánh xạ tới bất kỳ tên người dùng hợp lệ nào trong kho SVN bên ngoài, và nhiều người dùng Workspace có thể được ánh xạ tới cùng một tên người dùng trong kho SVN bên ngoài.

Bản thân quyền truy cập (theo nghĩa chỉ Đọc hoặc Đọc/Ghi) cuối cùng được quyết định bởi bản cài đặt kho bên ngoài. Enterprise Server không tác động đến việc phân quyền người dùng của kho bên ngoài, và do đó không thể quản lý các quyền này từ phía Enterprise Server.
Khi truy cập kho bên ngoài của Enterprise Server từ Altium Designer, chẳng hạn khi tạo một dự án mới, thông tin xác thực kết nối kho có thể được yêu cầu nếu việc này chưa từng được thực hiện trước đó. Các thông tin xác thực này sẽ được tự động dùng cho các hoạt động tiếp theo với kho này.

Truy cập bên ngoài tới một kho thiết kế SVN cục bộ

Một Design Repository được tạo thông qua dịch vụ Version Control cục bộ của Enterprise Server có thể được truy cập bằng ứng dụng khách SVN như TortoiseSVN. Việc truy cập được thực hiện bằng giao thức mạng thông thường (hiện tại svn:// được hỗ trợ). Địa chỉ kho chính xác có thể được truy cập/sao chép từ hai nơi:

Trang VCS trong giao diện trình duyệt của Workspace – trong trường Repository Path dành cho kho đích.

Một kho 'nội bộ' được tạo từ Enterprise Server sẽ hiển thị đường dẫn địa chỉ của nó tương đối so với Enterprise Server, tức là địa chỉ localhost của máy chủ host.

Từ trong Altium Designer, từ trang Data Management – Design Repositories page của hộp thoại Preferences – trong trường Repository dành cho kho đích.

Từ góc nhìn của Altium Designer – hoặc bất kỳ ứng dụng nào không nằm trên máy chủ host của Enterprise Server – các đường dẫn địa chỉ kho được dựa trên tên của các máy chủ host tương ứng.

Địa chỉ hiển thị sẽ phụ thuộc vào việc bạn truy cập kho từ cùng máy cài đặt Enterprise Server (svn://localhost/<RepositoryName>), hay từ một PC từ xa (svn://<ComputerName>/<RepositoryName>, trong đó ComputerName là tên của PC nơi Enterprise Server đang đặt).

Hãy dùng địa chỉ đã lấy được trong chức năng duyệt kho của ứng dụng khách Subversion. Ở lần truy cập đầu tiên, một hộp thoại Authentication trung gian sẽ mở ra để yêu cầu thông tin xác thực kết nối hợp lệ. Hãy nhập tên và mật khẩu của một tài khoản người dùng Workspace để tiếp tục. Các thông tin xác thực này hợp lệ nếu:

Tài khoản người dùng đã được thêm vào after kho được tạo trong Enterprise Server. Những người dùng áp dụng cho các kho đã tạo có thể được xem trong tệp passwd nằm trong thư mục \ProgramData\Altium\Altium365Data\Repository của PC Enterprise Server – xem bên dưới.
Kho đã được chia sẻ với tài khoản người dùng đó, bằng cách thêm tên người dùng đó qua lệnh Add User trong cửa sổ Manage Permissions for <repository name> của máy chủ. Điều này được thể hiện trong tệp authz của kho, nằm trong thư mục \ProgramData\Altium\Altium365Data\Repository của PC Enterprise Server.

Duyệt nội dung của một Design Repository được tạo thông qua dịch vụ Version Control cục bộ dựa trên SVN của bản cài đặt Enterprise Server.

Một Design Repository được tạo thông qua dịch vụ Version Control cục bộ sẽ có dữ liệu nội bộ được lưu trong một thư mục con tương ứng bên trong thư mục \ProgramData\Altium\Altium365Data\Repository (đối với bản cài đặt Enterprise Server mặc định). Khuyến nghị không nên thay đổi hoặc chỉnh sửa các tệp trong thư mục này, trừ nhân sự IT cho mục đích bảo trì.

Đồng bộ người dùng giữa Enterprise Server & VCS

Khi một người dùng mới cho Workspace được tạo, thông tin xác thực đã định nghĩa (User Name và Password) cho người dùng đó sẽ được lưu trong cả cơ sở dữ liệu của Enterprise Server và dịch vụ Version Control, vì dịch vụ sau không thể truy cập trực tiếp mật khẩu từ dịch vụ trước. Mật khẩu được lưu trong dịch vụ Version Control ở định dạng văn bản thuần (trong tệp \ProgramData\Altium\Altium365Data\Repository\passwd).

Các mục trong danh sách này cung cấp quyền truy cập vào kho SVN của Enterprise Server khi làm việc với dịch vụ này thông qua Altium Designer. Sẽ có những trường hợp thông tin xác thực của người dùng không có trong tệp, chẳng hạn như khi người dùng Workspace đã tồn tại trước khi kho SVN đầu tiên được tạo (thay vì ngược lại). Điều này có thể được xử lý bằng cách thêm thủ công các cặp tên/mật khẩu đó vào tệp passwd, hoặc nhập lại mật khẩu cho từng hồ sơ người dùng trong Workspace – cách sau sẽ tự động điền tệp passwd tương ứng mà không cần truy cập trực tiếp vào PC Enterprise Server.

Trong bản cài đặt Enterprise Server mặc định, thông tin xác thực người dùng được lưu cho dịch vụ Version Control trong tệp Passwd liên quan.

Xóa kho

Để xóa một kho khỏi dịch vụ Version Control của Enterprise Server, nhấp vào điều khiển Remove () liên quan đến kho đó, trên trang VCS trong giao diện Workspace trên trình duyệt.

Lưu ý rằng việc xóa một kho khỏi trang Data Management – Design Repositories page của hộp thoại Preferences trong Altium Designer chỉ loại bỏ kho đó khỏi việc được sử dụng bởi phiên bản Altium Designer đó. Nó không xóa kho khỏi dịch vụ Version Control của Enterprise Server. Nếu bạn đăng xuất khỏi Enterprise Server rồi đăng nhập lại, kho đó sẽ lại xuất hiện trong danh sách các kho khả dụng cho phiên bản Altium Designer đó.

Các mục kho bên ngoài có thể bị xóa bất kể kho đó có chứa dự án hay không. Ngược lại, các kho cục bộ (những kho được tạo nội bộ thông qua dịch vụ Version Control của Enterprise Server) không thể bị xóa nếu chúng chứa một hoặc nhiều dự án. Bạn sẽ được cảnh báo về điều này, và cần xóa các dự án trước rồi mới có thể tiếp tục việc xóa kho.

Ngay cả khi đó, nếu một kho cục bộ không có dự án nào, nó sẽ không thực sự bị xóa mà sẽ được chuyển vào một thư mục lưu trữ (\ProgramData\Altium\Altium365Data\RepositoryDumps, đối với bản cài đặt Enterprise Server mặc định). Kho đó sẽ được chứa trong một tệp Dump, với tiền tố Unique ID (ví dụ: 775f6c22-b9a1-468c-9f1f-4f217bb3be6b_central design repository.dump).

Phiên bản thân thiện với máy in

Bản địa hóa bằng AI

Nếu bạn phát hiện vấn đề, hãy chọn văn bản/hình ảnh và nhấnCtrl + Enterđể gửi phản hồi cho chúng tôi.